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W książce omówiono zasady posługiwania 
się najbardziej popularnym obecnie zesta- 
wem programów przeznaczonych do pisa- 
nia i uruchamiania programów o kodzie 
maszynowym na minikomputer 

ZX SPECTRUM. 

Współpracujące ze sobą asembler wraz z 
edytorem oraz monitor z programem uru- 
chamiającym (ang. debugger) stanowią 
niezbędne narzędzie dla programistów pi- 
szących w kodzie wewnętrznym. 
Znajomość zasad posługiwania się asem- 
blerem może okazać się przydatna także 
dla czytelników pism mikrokomputero- 
wych, którzy chcieliby uruchamiać na 
własnym komputerze zamieszczane na ła- 
mach tych pism programy. 

Liczne przykłady i uwagi dotyczące spo- 
sobu posługiwania się programami pozwa- 
lają na szybkie opanowanie prezentowane- 
go materiału. 


Ireneusz Węgiel 


Oprogramowanie podstawowe ZX SPĘCTRUM 
- DEVPAC 3 / GENS 3, MONS 3 / 


WSTĘP 


Pakiet programów znany pod nazwą "DEVPAC 3" angielskiej firmy 
Hisoft zawiera dwa programy: 

"GENS3" - program tłumaczący zapis symboliczny rozkazów mikro- 
procesora Z 80 na kod wynikowy (tzw. asemtler) oraz prosty i 
wygodny edytor przeznaczony do wpisywania tekstów własnych 
programów użytkownika, oraz | 

"MONS3" - program przeznaczony do uruchamiania (ang, debugger) 


i przeglądania programów w kodzie maszynowym (monitor). 


W pierwszej części przedstawiono zasady działania asemblera 

oraz sposób posługiwania się edytorem. Opis dotyczy programu 
"GENS3M21" oraz poprzedniej, najbardziej popularnej w Polsce 
wersji "GENS3"*, Podobnie postąpiono w części drugiej, gdzie 

prezentowana jest jedna z najnowszych wersji monitora - 


UMONS3M21", a także jego poprzednik - "MONS3", 


Większość informacji dotyczących nowszych wersji (M21) odnosi 
się także do ich poprzedników. Różnice między wrrsjami mające 
istotne znaczenie dla użytkowników programów GENS3 i MONS3, 
zostały zaznaczone w tekście instrukcji. Najważniejsze zmiany 
wprowadzone przez firmę Hisoft w wersjach "M21", to: 

- dołączenie programu ładującego "G/M 3M21", który ładuje 
MONS3M21 od adresu 30000 a GENS3M21 od adresu 37000; "G/M 
59M21" zmienia kolor tła i obrzeża na czarny, a kolor atra- 
mentu na biały, co sprawia, że korzystanie z programów jest 
mniej męczące 

- sygnalizowanie przyciśnięcia klawisza dźwiękiem (keyboard 
click) 

- likwidacja zmiennej wielkości bufora w programie GENS3M21 


oraz szereg drobnych zmian ułatwiających posługiwanie się 


med; iz 


programami, które zostały omówione w tekście instrukcji. 
Uwaga: 


znak "4" oznacza, że następująca po nim liczba jest zapisana 


w systemie szestnastkowym. 


Część I 


GENS3ZM21 


ASEMBLER I EDYTOR 


Ba 


ROZDZIAŁ 1. URUCHOMIENIE PROGRAMU 


Program GENS3M21 zajmuje około 10 KB pamięci (GENS3 - ok. 

7 KB) włącznie z własnym, wewnętrznym stosem. Użytkownik może 
wczytać program w dowolne miejsce w pamięci. Należy jednak 
pamiętać aby zapewnić wystarczającą ilość pamięci na tekst 
programu użytkownika oraz tablicę symboli, które umieszczane 
są bezpośrednio po programie GENS3M21. Z tego względu wygodnie 
jest ładować program na początku pamięci. 


1.1 Ładowanie i uruchamianie programu GENS3M21 


GENS3M21 można załadować przy użyciu programu ładującego 
"G/M: 3M21", który umieszcza program od adresu 37000 lub za 
„pomocą komendy: 

LOAD "GENS3M21" CODE aa 
gdzie aa oznacza adres, od którego chcemy umieścić program, 
Uruchomienie programu odbywa się poprzez skok do adresu począt- 
- kowego aa: 

RANDOMIZE USR aa 
Po uruchomieniu programu automatycznie zgłasza się edytor - 
patrz rozdział 3, 
Ponowne uruchomienie programu GENS3M21 (tzn. po powrocie do 
systemu operacyjnego ZX SPECTRUM) może nastąpić w ten sam spo» 
sób, czyli: 

RANDOMIZE USR aa 
jest to tzw. ciepły start; nie powodujący zniszczenia poprzed 
nio wpisanego tekstu programu użytkownika, albo: 

RANDOMIZE USR aa+3 
- zimny start, po którym tekst programu użytkownika zostanie 
zniszczony a argumentom komend edytora zostaną przypisane war= 


tości początkowe. 


si6 = 


Przykład: 
załóżmy, że chcemy załadować program GENS3M21 od adresu 24000 
aby zostawić ok..30 KB wolnej pamięci na tekst własnego prog 
ramu. 
i1adowanie programu 
LOAD "GENS3M21" CODE 24000 
Uruchomienie programu i ciepły start 
RANDOMIZE USR 24000 
Zimny start 


RANDOMIZE USR 24003 
1.2 Ładowanie i uruchamianie programu GENS3 


Program GENS3 ładujemy za pomocą komendy; 

LOAD "GENS3" CODE aa 
gdzie aa jest adresem, od którego chcemy umieścić program, 
Po załadowaniu GENS3, wejście do prógramu odbywa się poprzez 
Skok do adresu początkowego aa: 

RANDOMIZE USR aa 
Program zgłasza się pytaniem o wielkość bufora: 

"Buffer size?" 
na które odpowiadamy wpisując cyfrę od 0 do 9 włącznie i 
ENTER lub samo ENTER (co odpowiada cyfrze 4). Cyfra, którą 
wpisujemy, określa wielkość bufora w jednostkach równych 256 
bajtom; zero spowoduje utworzenie bufora o wielkości 64 bajtów, 
Bufor jest wykorzystywany przy nagrywaniu i wczytywaniu teks= 
tów programów przeznaczonych do natychmiastowej asemblacji = 
szezegóły w rozdziale 2,9, komenda eF, 
Wielkość bufora możemy określić tylko raz, po pierwszym uru- 
chomieniu programu. 
Ponowne uruchomienie programu GENS3 odbywa się w następujący 
sposób: 


wę 2 


RANDOMIZE USR: aa+56 /- zimny start 
aAbo 
RANDOMIZE USR aa+61 - ciepły start 
Uwaga: skok do adresu początkowego programu GENS3 może nastą= 
pić tylko raz po uruchomieniu programu. 
Przykład: 
załóżmy, że chcemy załadować GENS3 od adresu 29944, 
Ładowanie programu 
LOAD "GENS3" CODE 29944 
Uruchomienie programu 
RANDOMIZE USR 29944 
Zimny start 
RANDOMIZE USR 30000 
Ciepły start 
RANDOMIZE USR 30005 


ROZDZIAŁ 2. OPIS PROGRAMU GENv3M21 


2.1 Zasada działania asemblera 


GENS3M21 jest szybkim, dwuprzebiesowym asemblerem Z80, Do= 

konuje asemblacji wszystkich standardowych mnemoni ków roz” 

kazów mikroprocesora Z80, Lista wszystkich nnomoników 36 

została zanieszczona w załączniku Je 

Po wywołaniu asemblera (za pomocą komendy "A" edytora -— 

- patrz: rozdział 3,2) należy określić wielkość tablicy 

symboli (patrz: rozdział 2,5) w odpowiedzi na pytanie "Table 

size:". Wpisujemy liczbę dziesiętną i ENTER lub samo ENTER, 

Ww tym śwłatńia przypadku asembler wybierze wielkość tablicy 

„proporcjonalnie do długości tekstu programu użytkownika, co 

na ogół wystarcza, 

Uwaga: 'używając komendy «F (patrz: rozdział 2,9) może zajść 

potrzeba określenia większej niż normalnie tablicy symboli - 

- asembler nie może przewidzieć długości tekstu wczytywane- 

go z ta_mye 

Następnie pojawia się pytanie "Options:", co umożliwia wy= 

branie jednej lub kilku z następujących opcji: 

1 wyświetla tablicę symboli po drugim przebiegu asemblera 

2 .asemblacja bez generowania kodu wynikowego 

4 asemblacja bez listingu tekstu proęgramu 

8 listing asemblera skierowywany jest na drukarkę 

16 umieszcza kod wynikowy, jeżeli jest generowany, po tablicy 
symboli. Licznik Adresów przyjmuje wartości podawane 
przez JRG, tak więc można umieścić bezpośrednio po tabli- 


cy symboli kod wynikowy przeznaczony do wykonywania w 


sg. 


w innym miejscu pamięci, 

32 wyłącza sprawdzanie, w którym miejscu w pamięci jest u- 
mieszczomy kod wynikowy - opcja stosowana w celu przys- 
pieszenia asemblacji. 

W odpowiedźżi na "Options:" możemy wpisać: 

ENTER - żadna z opoji nie zostanie wybrana 
numer wybranej opcji 
sumę numerów wybranych opcji 

Po udzieleniu odpowiedzi na powyższe pytania, wyświetlany 

jest nagłówek asemblera: 

»HISOFT GENSŻM2 ASSEMBLER= 
ZX SPECTRUM 

Copyright (C) HISOFT 1983,4 

A11l right reserved 


i zaczyna się asemblacja. 


Asemblacja jest dwuprzebiegowa: podczas pierwszego przebie- 
gu GENS3M21 sprawdza poprawność składniową tekstu i tworzy 
tablicę symboli, w drugim przebiegu generowany jest kod wy». 
nikowy (jeśli nie została wybrana opcja numer 2), 

Podczas pierwszego przebiegu wyświetlane są jedynie wier- 
sze zawierające błąd wraz z podanym numerem błędu (patrz: 
załącznik 1), np.: 


120 SBV HL,DE 
*ERROR« 2 błąd numer 2. 


W przypadku wykrycia błędu, asemblacja zostaje zatrzymana, 
Po naciśnięciu "E" nastąpi powrót do edytora, a dowolnego 
innego klawisza - kontynuowanie asemblacji od następnego 


wiersza, 
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Po pierwszym przebiegu wyświetlany jest komunikat: 

Pass 1 errors: n (pierwsży przebieg, n błędów) 
Jeśli choć jeden błąd został wykryty, asembler nie przystą- 
pi do generowania kodu wynikowego. Jeżeli w tekście programu 
są odwołania do niezadeklarowanych etykiet, ukazują się ko- 
munikaty, np.: 

*WARNING« START absent 

(UWAGA brak etykiety o nazwie START) 
Podczas drugiego przebiegu, oprócz generowania kodu wyni- 
kowego, wyświetlany jest listing asemblera (jeśli nie został 
wyłączony przez opcję. nr 4 lub komendę +L- asemblera), 


Postać listingu asemblera jest następująca: 


kolumny 
ekranu 1 46 15 21 26 31 
D5AA CDB2D6 720 PODPR1 + Stykieta 
CALL 4D6B2 
format 
rozkazu mnemonik argumenty 
wartość numer 
Licznika wiersza 
Adresów 


Na początku każdej linii znajduje się wartość Licznika Ad- 
resów, chyba, że w danym wierszu znajduje się jeden z pseudo- 
-mnemoników: ORG, EQU lub ENT (patrz: rozdział 2,7) - wtedy 
wyświetlana w tym miejscu liczba jest równa wartości znajdu- 
jącej się w polu argumentów rozkazu, System, w jakim wyświet- 
lane są te liczby możemy zmienić na dziesiętny umieszcza jąc 

w tekście programu komendę «D+ asemblera (patrz: rozdział 
2.9). Po adresie wyświetlana jest zawartość komórek pamięci 
(maksimum czterech - kod najdłuższego rozkazu mikroprocesora 
7280) składająca się na jeden rozkaz kodu wynikowego. Fragment 


listingu reprezentujący format rozkazu możemy usunąć za po- 


= gif 2 


mocą komendy «*C- asemblera (patrz: rozdział 2,9), 
Następną liczbą jest numer wiersza - od 1 do 32767, W ko= 
lumnach 21-26 wyświetlane jest 6 pierwszych znaków etykiety, 
Pozostała część wierszęą programu zajmuje kolejne linie e- 
kranu, począwszy od 21 kolumny: mnemonik (kolumny 21-24), 
argumenty (od 26 kolumny) oraz komentarze, 
Taki format listingu poprawia czytelność wydruku gdy w jed- 
nej linii można wyświetlić maksimum 32 znaki: Istnieje moż- 
liwóść zmiany formatu listingu asemblera poprzez wpisanie 
do odpowiednich komórek pamięci, zajmowanej przez GENS3M21 
„liczb określających: 
a, w której kolumnie kończy się pierwsza linia ekranu. 
Wpisujemy numer kolumny pomniejszony o 5, Początkowo 
w komórce pamięci o adresie podanym poniżej, znajduje 
się liczba 22, co oznacza, że pierwsza linia ekranu 
kończy się w kolumnie 27. Zmieniając tę liczbę na 0 u- 
zyskamy pełną szerokość wydruku. 
Adres: początek programu GENS3M21+51 
b. w której kolumnie zaczyna się każda kolejna linia ekra- 
nu. 
Adres: początek programu GENS3M21+52 
c. ilość znaków wyświetlanych w drugiej i <ażdej następnej 
linii ekranu. | 
Adres: początek programu GENS3M21+53 
Na przykład, jeśli chcemy, aby pierwsza linia ekranu zawie- 
rała 14 znaków (tj. tylko adres i format rozkazu), a nas- 
tępne zaczynały się od pierwszej kolumny i wypełniały całą 
linię, należy wprowadzić następujące instrukcje z BASICa 
(załóżmy, że program GENS3M21 został załadowany od adresu 


37000): 


POKE 37051,9 14-5 = 9 

PO„E 37052,1 musi być co najmniej jedna spa- 
cja na początku każdej następ- 
nej linii 

POKE 37053,31 31 znaków 


Powyższe modyfikacje zostaną uwzględnione pod warunkiem, że 
nie będziemy stosować komendy sC- asemblera. 
Listing asemblera można zatrzymywać wciskając SPACE (w pro- 
gramie MONS3 - BREAK), ży następnie wrócić do edytora - kla- 
wisz'E", lub kontynuować asemblację - dowolny klawisz. 
Jedynymi błędami, jakie mogą wystąpić podczas drugiego prze- 
biegu asemblera, są sERROÓR« 10 i "Bad ORGIE" (patrz: załącz- 
nik 1). "Bad ORG!" występuje, jeśli generowany kod wynikowy 
mógłby zniszczyć GENS5M21, tekst programu użytkownika lub 
tablicę symboli. Błąd ten przerywa asemblację i przekazuje 
sterowanie do edytora. Po »ERROR» 10 asemblacja może być kon- 
tynuowana, Po drugim przebiegu wyświetlany jest komunikat: 

Pass 2 errors: n (drugi przebieg, n błędów) 
Następnie pojawiają się ostrzeżenia o niezadeklarowanych e- 
tykietach oraz informacja o wielkości tablicy symboli w po- 
równaniu z wielkością wstępnie przydzieloną: 

Table used; x from y 
gdzie x oznacza wielkość tablicy symboli a y wielkość zare- 
zerwowanego obszaru. 
W końcu, jeśli została prawidłowo użyta dyrektywa ENT (patrz: 
rozdział2.7), wyświetlany jest komunikat: 

Executes: aa 
gdzie aa oznacza adres, od którego zestanie wykonany kod wy- 


nikowy gdy użyjemy komendy edytora "R". (patrz: rozdział 3.2), 


=13% 


Gdy została wybrana opcja numer 1, asembler wyświetli listę 
etykiet wraz z odpowiadającymi im wartościami. Po zakończe- 


niu asemblacji sterowanie jest przekazywane do edytora, 
2,2 Postać wierszy programu 


Każdy wiersz programu użytkownika przeznaczony do asembla- 


cji przez GEN03M21 powinien mieć następujący format; 


NUMER ETYKIETA MNEZMONIK ARGUMENTY KOMENTARZ 
WTERSZA 


100 START LD DE, (LISTA) ; inicjalizuj 
wskaźnik 


Wiersze programu są analizowane przez asembler w następują” 

cy sposób; 

Badany jest pierwszy znak w wierszu (po numerze wiersza i spa- 
cji) i następne kroki zależą od tego, jaxi to jest znak. Jeś- 
li pierwszym znakiem jest: 

UAT cały wiersz jest traktowany jako komentarz 


nz" spodziewany jest symbol jednej z komend asem- 
blera (patrz: rozdział 2.9). Pozostałe znaki 
są traktowane jako komentarz. 


ENTER (CHR$ 13) czyli znak końca wiersza - wiersz jest pomi- 
jany 
LS spacja lub znak tabulatora - pierwszy znak 


nie będący spacją ani znakiem tabulatora trak 
towany jest jako początek mnemonika Z80, 


inny znak asembler traktuje to jako początek etykiety 
Jesli etykieta jest prawidłowa lub jeśli pierwszym znakiem w 
wierszu jest spacja (znak tabulatora), to następny znak nie 
będący spacją (znakiem tabulatora) traktowany jest jako po= 
czątek mnemonika Z80 (patrz: załącznik 2) o długości do 4 zna” 


ków i zakończony spacją (znakiem tabulatora) lub znakiem 
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końca wiersza. Jeśli mnemonik jest prawidłowy i wymaga ar- 
gumentów, wtedy następujące po nim spacje są pomijane i prze” 
twarzane jest pole argumentów, 

Wiersze mogą zawierać same etykiety (w celu zwiększenia czy- 
telności tekstu). Komentarze, poprzedzone znakiem "z", mogą 
występować w dowolnyp miejscu po argumentach lub, jeśli mne- 
monik nie wymaga argumentów, po mnemoniku. 


2.3 Etykiety 


Podczas pisania programów w postaci symbolicznej bardzo 
często stosuje się tzw. adresy symboliczne lub stałe noszą= 
ce ogólną nazwę etykiet. Etykiety reprezentują 16 bżtów-in- 
formacji. Stosowanie etykiet uwalnia programistę od kłopotów 
jakie stwarzałoby obliczanie adresów komórek pamięci, w ja= 
kich znajdują się poszczególne rozkazy. Poza tym etykiety 
znacznie zwiększają czytelność programów, zaś w przypadku 
konieczności wstawienia lub usunięcia rozkazów z programu, 
programista nie musi zmieniać adresów i skoków. 

Wartości etykiet obliczane są w pierwszym przebiegu asemble- 
ra lub podawane przez programistę (patrz: dyrektywa EQU - 

- rozdział 2.7). Gdy etykieta nie zostenie zadeklarowana, 
pojawi się ostrzeżenie («WARNING»), a jako wartość etykiety 
jest przyjmowana bieżąca wartość Licznika Adresów, Jeśli ety= 
kieta reprezentuje wartość większą niż 8 bitów i zostanie 
użyta w miejscu, gdzie spodziewana jest stała 8-bitowa,wys= 
tąpi błąd: »ERRORe 10 (w drugim przebiegu asemblera), np.: 


INDEKS EQU  *10AB 
LD B,INDEKS 


Etykiecie o nazwie INDEKS została przypisana wartość 410AB, 


64152 


natomiast rozkaz LD B,n wymaga argumentu 8-bitowego. Jeśli 

w tego typu przypadkach asemblacja zostanie doprowadzona do 
końca,to zostanie przyjęta wartość mniej znaczącego bajtu 
etykiety (wAB). 

Nazwa etykiety może zawierać dowolną liczbę znaków, lecz tyl- 
ko pierwsze 6 znaków jest ważnych; te sześć znaków musi sta= 
nowić jedyną (niepowtarzalną) nazwę, ponieważ etykieta nie 
może być deklarowana ponownie («ERRORe 4). Etykietą nie mo= 
że być słowo zastrzeżone (patrz: załącznik 2), ale może ono 
być użyte jako część nazwy etykiety. Nazwa etykiety może 
składać się ze znaków: cyfry (od 0 do 9), wielkie i małe li- 
tery (od a do Z) oraz $,/,[, J,t, _,4. Pierwszym znakiem 
musi być litera. Przykłady poprawnych etykiet: 


KONIEC 

koniec 

AT[1] 

adr_10 

RRCA RRCA nie jest słowem zastrzeżonym 
b/z 


Alfabetyczny spis wszystkich etykiet użytych w programie 


możemy otrzymać wybierając opcję nr 1. 
2.4 Licznik Adresów 


W Liczniku Adresów przechowywany jest bieżący adres komórki 
pamięci, do której wpisuje się kod rozkazu. Licznik Adresów 
umożliwia przypisanie wartości (równej adresowi) poszcze- 
gólnym etykżetom i wprowadzenie ich do tablicy symboli, 
Wartości Licznika Adresów podawane są w listingu asemblera. 
Licznik Adresów może być ustawiony na dowolną wartość za 


pomocą dyrektywy ORG (patrz: rozdział 2.7). Jeżeli dyrekty- 
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wa ORG nie zostanie użyta, Licznik Adresów jest ustawiany 
na adres pierwszego bajtu po tablicy symboli. Wartość Licz 
nika Adresów jest dostępna w programie poprzez symbol "$n, 
np. : LD HL,$+12 spowoduje wygenerowanie kodu odpowiadają- 
cego bieżącej wartości Licznika Adresów +12 i taka wartość 
zostanie załadowana do rejestru HL podczas wykonania pro- 


gramu. 
2.5 Tablica symboli 


btykieta napotkana po raz pierwszy podczas asemblacji jest 
unieszczan«: w tablicy syuboli wraz z dwoma wska ;nikami o- 
kreślającymi, 'o zakończeniu asemblacji, jej miejsce w porząd- 
ku alfabetycznym. Gdy dana etykieta zn:.jduje się w polu e- 
tykiet (zostuła zudeklarowana), jej wartość (równa bieżą- 

c j wurtosci Licznixa Adresów lub wyraceniu po dyrcktywie 
„.44) jest umieszczuna w tablicy sy'boli, 

Tablice syaboli jest zoryanizowuna w postaci drzewa binarne- 
10, CO umo.jliwia bardzo szybkie wprowiuczanie i wyszukiwanie 
poszczególnych „ymboli. Jedna etykieta zajmuje, w zależnoś- 
ci od długości jej nazwy, od 8 do 175 bajtów w tablicy sym= 
boli. W tablicy symboli umieszcza się tylko 6 pierwszych 
znaków nazwy : tykiety, w celu ograniczenia miejsca zajmo= 
wanego przezecykiety. Jeśli etykiet jest deklarowana więc j 


ni. jeden raz, wyświetlany ject komunikat błędu eERRORe 4, * 
2.6 wyrażenia 


„semblev Gziio9N21, akceptuje oprucz stałych liczbowych i ety- 
<siet jażo argumentów, również wyrażenia, Jest to istotne u- 


łatwienie dla »n:ogramisty, gdyż nie «usi on obliczać wartości 


wyrażeń przed wpisywaniem programu. Wartości wyrażeń są ob- 
liczane podczas pierwszego przebiegu asemblera. Wyrażenie 
składa się z czynnika lub kilku czynników oddzielonych o0- 
peratorami: 


czynnik stała dziesiętna, np, 6128 

stała szesnastkowa - poprzedzona znakiem 4, np. 
*40AF 

stała dwójkowa - poprzedzona znakiem %, np. 
% 1001011 

stała znakowa - ujęta w cudzysłów, np. "W" 

etykieta, np. Buforf 

$ - oznacza bieżącą wartość Licznika Adresów 


GENS3M21 uwzględnia tylko 16 najmniej znaczących bitów licz- 
by (tzn. MOD 65536) - np. w FC84E stanie się *C84E a 68749 - 
- 3219, 


operator + dodawanie 
- ode jmowanie 
k iloczyn logiczny - AND 
e suma logiczna - OR 
! suma modulo dwa - XOR 
. mnożenie całkowite 
Z dzielenie całkowite - DIV 
? modulo - MOD tzn. a?b = a-(a/b)sa 


Wszystkie operatory posiadają równy priorytet - wyrażenia są 
obliczane od lewej do prawej strony, 

Wyrażenie ujęte w nawiasy jest traktowane jako adres pamięci, 
Np. LD IX, (tabl+8) jest rozkazem przesłania do rejestru IX 
zawartości komórek pamięci o adresach tabl+8 i tabl+9, 


Przykłady prawidłowych wyrażeń (zakładamy, że etykieta o naz- 


wie STO = 100): 
wyrażenia wartość wyrażenia 
wyliczona przez asembler 
% 2AAA+STO * 2BOE 


%110110 £ %10001 % 1000 
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"dm r 12+8TO *BF 
12+3-6/11 2 
X1118"_" 45P 


($+S5To ? 3000) 
UWAGA: spacje można umieszczać między czynnikiem a operato- 
rem ale nie wewnątrz czynników, 
Jeśli wartość mnożenia będzie większa niż 32767, to wystąpi 
błąd wERRORw15, a dzielenie przez zero spowoduje błąd 
*ERROR»14 - w innych przypadkach nadmiar będzie ignorowany, 
W działaniach arytmetycznych stosowany jest kod U2, tzn. 
liczby większe od 32767 (%47FFF) są traktowane jako ujemne, 
np. 52000 = -13>36 (52000=65536)» 
Argumentami rozkazów skoku względnego (Jii i DJNZ) mogą być 
adres skoku (liczba lub etykieta) lub wyrażenie "$+ł przesu- 
nięcie wzęlędne"., W pierws:ym przypadku asembler wyliczy od- 
powiednie przesunięcie i wstawi je do kodu. Przesunięcie ovL- 
liczane jest jako różnica pvodanej wartości argumentu i war 
tości Licznika Adresów dla następnego rozkazu (czyli $+2), np.: 

B3CE  180E 90 JR  4B3DE 
Przesunięcie (40E) zostało obliczone w następujący sposób: 

4 B3DE-(% B3CE+2)=spOE 
W drugim przypadku adres skoku względnego będzie obliczany 
względem wartości Licznika Adresów bieżącego rozkazu, Prze 
sunięcie względne może więc zawierać się w granicach od -126 
do +129 włącznie, Aby nie wprowadzać zamieszania, rozkaz sko= 
ku względnego zapisuje się zwykle jako 
JR $+2+d 

gdzie d oznacza przesunięcie względne, które zawiera się w 


granicach od -128 do +127 włącznie, 
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Jeśli podane lub wyliczone przesunięcie względne będzie poza 
dozwolonym zakresem, to wyświetlony zostanie komunikat błędu: 


*ERROR=e 10, 
2.7 Dyrektywy asemblera 


Asembler GENS3M21 rozpoznaje, oprócz mnemoników rozkazów mi- 
kroprocesora Z80, pseudo-mnemoniki, czyli tzw. dyrektywy a- 
semblera, Dyrektywy nie meją wpływu na mikroprocesor podczas 
wykonywania pro. ramu tzn. nie są unieszczane w kodzie wyni- 
kowym a służą jedynie do przekazywania pewnych informacji 
asemblerowi. Działania podjęt" przez asembler w wyniku tych 
informacji zmieniają w pewien sposób kod wynikowy generowany 
przez GEN5S3M21. Pseudo-mnemoniki są traktowane podobnie jak 
mnemoniki rozkazów; mogą być poprzed:one etykietą, a po nich 
może wystęrować komentarz. Dyrekty.y są następujące: 

EQU wyrażenie 
musi być poprzedzone etykietą. Przypisuje podanej etykiecie 
wartość wyrażenia. Wyrażenie nie może zawierać symbolu, któ- 
remu nie została jeszcze przypisana żadna wartość, («ERRORm 13) 

ORG wyrażenie 
ustawia Licznik Adresów na wartość wyrażenia; oznacza to, że 
kod wynikówy zostanie umieszczony od adresu podanego przez 
ONRG+ Jeśli nie zostały wybrane opcje 2 lub 16 a wartość wy* 
rażenia jest taka, że generowany kod wynikowy mógłby znisz- 
czyć brogram GENS3M21, tekst programu użytkownika lub tabli- 
cę symboli, to wyświetlany jest komunikat "Bad ORG!" i asem- 
blacja zostaje przerwana, W takim wypadku możemy dokonać a= 
semblacji ponownie wybierając opcję nr 16. Kod wynikowy zos= 
tanie umieszczony po tablicy symboli ale Licznik Adresów 


przyjmie wartość podaną przez ORG. Adres początku obs_aru 
pamięci, w którym umieszczony został kod wynikowy możemy 
obliczyć dodając następujące wielkości: adres końca tek- 
stu (patrz: komend: 1 edytora, rozdział 3.2) oraz wiel- 
kość tablicy symboli + 2. Wygenerowany w ten sposób kod 
wynikowy należy przed wykonaniem przesunąć do miejsca o- 
kreślonego przez ORu, 

UNT wyrażenie 
ustala wartość adresu, od którego zostanie wykonany kod 
wynikowy po komendzie "R" edytora (patrz: rozdział 3,2), 
np.: 


uNT 42133 - wykonanie «odu od adresu 421>3 
Bi:T $ - wykonanie kodu ot adrefu w Li- 
czniku Adresów 


U.aga: jeżeli została wybrana opcja 16, dyrektywa ENT nie 
będzie wykonana, 

DSYB wyrażenie, wy:ażenie;e.. 
wartość danego wyrażenia może być co najwyżej 3-bitowa, 
Do komórki pamięci adresovanej br:ez Licznik Adresów zosta- 
nie wpisana wartość daneg» wyrażenia, po czym Licznik Adre- 
sów zostanie zwiększony o 1, Te operacje są powtarzane dla 
kazdego wyrażenia, 

DEFW wyrażenie, wyrażenie,... 
słowo (2 bajty) równe wartości wyrażenia zostanie wpisane 
do komórek pamięci adresowanych przez Licznik Adresów 
(mniej znaczący bajt najpierw), po czym Lic.nik Adresów zos- 
tanie zwiększony o 2, Te operacje są powtarzane dla każd”go 
wyrażenia, 

DEFS wyrażenie 


zwiększą Licznik Adresów o wartość wyrażenia - równoznaczne 


sk ózażwówania obszaru pamięci o wielkości równej wartości 
wyrażenia, 

DEFM "c" 
"c" jest ciągiem znaków o długości n; do n komórek pamięci 
począwszy od adresu w Liczniku Adresów zostaną wpisane posz= 
czególne znaki ciągu "c" w kodzie ASCII. Długość ciągu może 
teoretycznie wynosić 255 znaków, ale w praktyce limitowana 
jest przez długość wiersza, który możemy wprowadzić za po- 
mocą edytora, Pierwszy znak ciągu (") nie jest wpisywany po- 
dobnie jak ostatni, którym może być cudzysłów (") lub znak 


końca wiersza (ENTER) « 
2,3 Warunkowe pseudo-mnemoniki 


Warunkowe pseudo-mnemoniki pozwalają na wyłączenie części 
tekstu programu z procesu asemblacji: 
IF wyrażenie 
jeżeli wartość wyrażenia jest równa zero, asemblacja zostaje 
wyłączona (następne wiersze programu są pomijane przez asem= 
bler) aż do napotkania ELSE lub END. Jeśli wartość wyrażenia 
jest różna od zera, asemblacja jest komtynuowana normalnie, 
ELSE 
włącza i wyłącza asemblację, Jeśli przed napotkaniem ELSE 
asemblacja dokonywała się normalnie (była włączona), to zos- 
tanie wyłączona i odwrotnie, 
| END 
powoduje włączenie asemblacji. 
Uwaga: warunkowe pseudm-mnernoniki nie mogą być zagn.eżdżane; 
| zachowanie asemblera po napotkaniu zagnieżdżonych IF 


jest nieokreślone» 
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2.9 Komendy asemblera 


"Komendy asemblera, podobnie jak dyrektywy, nie mają wpły= 
wu na mikroprocesor podczas wykonywania programu, ponieważ 
nie są umieszczane w kodzie wynikowym, Co więcej, w przeci= 
wieństwie do dyrektyw asemblera, nie wpływają również na ge- 
nerowanie kodu wynikowego (oprócz komendy »F), - służą jedy- 
nie do modyfikacji listingu asemblera, . 
Komenda asemblera składa się z gwiazdki "s" (która musi być 
pierwszym znakiem w wierszu) oraz wielkiej litery, a komen- 
dy "L", "C" i "D", dodatkowo ze znaku "+" lub "=", 
W wierszu można umieścić tylko jedną koriendię; pozostałe zna- 
ki traktowane są jako komentarz. 
Komendy asemblera są następujące: 
*L- wyłącza listing od danego wiersza 
L+ listing zostaje włączony począwszy od tego wiersza 
«C= skraca listing asemblera począwszy od następnego wier= 
sza. Skrócony listing nie zawiera przedstawienia kodu 
wynikowego. Zostaje w ten sposób zaoszczędzonych 9 zna= 
ków, co umożliwia zmieszczenie prawie każdego wiersza 
pro, ranu w jednej linii ekranu poprawiając tym samym 
czytelność listingu. 
*C+ przywraca pełną postać listingu opisaną w rozdziale 2,1 
eD+ powoduje wyświetlenie wartości Licznika Adresów w sys- 
temie dziesiętnym. 
e*D- wartości Licznika Adresów zostają z powrotem wyświetla- 
ne w postaci liczb szesnastkowych» 
*E powoduje wyświetlenie trzech pustych linii na ekranie 
- komenda używana w celu wizualnego oddzielania bloków 
«Hs wykonuje sE i wyświetla ciąg znaków s, który może ozna= 


czać np. nagłówek modułu. Ciąg s jest wyświetlany po każ 
dej następnej komendzie »E. 

LP zatrzymuje listing asemblera. Po naciśnięciu dowolnego 
klawisza listing jest kontynuowany. +*S nie zatrzymuje 
listingu na drukarce. 

*F nazwa 

Komenda «F umożliwia asemblację tekstu bezpośrednio z taśmy. 

Tekst jest SESOY do bufora, po jednym bloku, a następnie 

tłumaczony. Pozwala to na tworzenie dużych programów, gdyż 


tekst programu nie zajmuje miejsca w pamięci, 


Po literze F i spacji podaje się nazwę zbioru na taśmie, Nazwa 
może zawierać maksimum 10 znaków, Jeżeli nie podamy nazwy, to 


zostanie załadowany pierwszy zbiór znaleziony na taśmie, 


mekst przeznaczony dę asemblacji z taśmy, musi być zapisany za 
pomocą komendy "T" edytora (nie "P") - "T" zapisuje tekst w 
porcjach (blokach) równych wielkości bufora z odpowiednimi 
przerwami, w czasie których tekst jest tłumaczony. 
w programie GENsS3 wielkość bufora równa się: liczbie podanej 
w odpowiedzi na pytanie "Buffor size?" (patrz: rozdział 1) 
pomnożonej przez 256 bajtów. Zwiększenie wielkości bufora 
„pozwala na skrócenie czasu asemblacji i ładowania tekstu kosz= 
tem zajętości pamięci i odwrotnie. Wielkość bufora w czasie 
nagrywania tekstu na taśmę musi być taka sama jak w czasie 
ładowania. Wygodnie jest więc nagrać tekst za pomocą komendy 
"pu, a później, w razie potrzeby, nagrywać ten tekst w blokach 
(komendą "T") dla różnych wielkości buforów, Możliwość zmia- 
ny wielkości bufora okażała się dość żadko wykorzystywana 
przez użytkowników, dlatego autorzy następnych wersji GENS3 
wprowadzili stałą wielkość bufora, 


Po napotkaniu komendy "«»F" pojawia się napis "start tape..." 


(włącz taśmę), zarówno w pierwszym jak i w drugim przebiegu 
asemblera. Należy włączyć taśmę za każdym razem. Komunikat 
"Pound nazwa" oznacza znalezienie zbioru o innej nazwie niż 


podana w komendzie «F a "Using nazwa” - ładowanie zbioru. 


Przykład użycia komendy aF został podany w rozdziale 4, 
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ROZDZIAŁ 3. EDYTOR 


3.1 Wprowadzenie 


Edytor dołączony do wszystkich wersji programu GENS3 jest 
prostym edytorem wierszowym, zaprojektowanym do pracy ze 
wszystkimi systemami operacyjnymi 280. Pozwala na szybką 

i wydajną edycję programów, 

Aby zaoszczędzić ilość pamięci, w której przechowywany jest 
tekst programu użytkownika, spacje na początku każdego 
wiersza, między etykietą a mnemonikiem, między mnemoni- 
kiem a polem argumentów oraz między argumentami a komen- 
tarzem są zamieniane na jeden znak tabulatora. Spacje w 
komentarzach nie ulegają kompresji, 

Uwaga: spacje nie mogą występować w etykietach, mnemonikach 


ani w polu argumentów. 


W rozdziale 3 używa sią następujących oznaczeń znaków ste= 


rujących: 

ENTER znak końca wiersza 

EDIT CAPS SHIFT 1 powrót do trybu przyjmowania 
komend 

DELETE CAPS SHIFT 0 kasuje jeden znak na łewo od 
pozycji kursora 

cs 8 CAPS SHIFT 8 (=©) przesuwa kursor do następnej 
pozycji tabulatora 

CS 5 CAPS SHIFT 5 (G©=) kasuje cały wiersz 


Edytor zgłasza się automatycznie po uruchomieniu programu 
GENS3M21 : 

Copyright (Q HISOFT 1983,4 

All Rights Reserved 


> 


Znek ">" oznacza gotowość edytora do przyjmowagia komend 


o następującej poBtaci: 
C N1,N2,51,52 ENTER 


gdzie 

c symbol komendy (ratrz: rozdział 3,2) 

N1,N2 numery wierszy od | do 32767 włącznie 

S1,52 łańcuchy znaków o długości do 20 znaków 
przecinek używany jest do rozdzielania poszczególnych argum 
mentów (patrz: komenda "S"), Specje poza łańcuchemi są po- 
mijane, Argumenty nie są obowiązkowe, ci.ociaż nieztóre ko= 
mendy (n.e. D - Delete) nie zestaną wykonane bez argumentów 
N1,N2, Kidytor pamięta wartości argumentów ostatnio wprowa= 
dzonych przez użytkownika i używa iciu, jeśli nowe wartości 
nie zostały pocane. Zmienne N1 i N2 są początkowo ustawio= 
ne na 10 a tańcuchy puste, Komendy nieważne są ignorowane 
i wyświetlany jest somunikat "Pardoa7", "en «omunikat po- 
jawia się również guy długość łańcucha S2 przekracza 
20 znaków; jeśli łańcuch 51 jest dłuższy niż 20 znaków to 
znaki od 21 wzwyż b;dą pomijane, 
Komendy można wprowadzać wielkimi i małymi !1terani, 
Podczas wpisywania komend można używać wszystkich znaków 
sterujących opisanych powyżej, np. C3 5 aby skarować 


wszystkie znaki, 
3,2 Komendy edytora 


Pomiż2, przedstawione zosgtały wszystkie korendy edytora, 
gwiazjxa (u; przy komendzie oznacza, że aryumenty muszą 


Lyć podane aby komenda została wykonana, 


Wstawianie tekstu 

Do programu można wstawić dowolny tekst piszęc numer wier- 
szą, spację i żądany tekst lub za pomocą komendy I. Jeśli 
wprowadzony zostanie wiersz o numerze już istniejącym w 
tekście programu, to istniejący wiersz zostanie usunięty 

i zastąpiony nowym. Wpisanie samego numeru wiersza (bez 
tekstu) spowoduje usunięcie z programu wiersza o tym nume- 
rze (jeśli istnieje). 

Wpisując tekst możemy używać wszystkich znaków sterujących 
wymienionych w rozdziale 7.1. Wiersz jest wprowadzany do 
programu po naciśnięciu ENTER. Tekst jest wprowadzany do 
bufora i jeśli bufor zostanie całkowicie zapełniony, nie 
będzie można wpisać żadnego znaku - należy wtedy zrobić 
miejsce za pomocą DELETL lub CS 5, 

Jeśli podczas wpisywania tekstu, edytor stwierdzi, że ko- 
niec tekstu jest blisko RAMTOP, wyświetla komunikat: 

"Bad Memory!". Oznacza *, że nie można wpisać więcej tek- 


stu i należy nagrać na taśmę część lub cały tekst, 


Komenda: I n,m 
Automatyczny tryb wstawiania. Edytor podaje numery wierszy 
zaczynając od n z krokiem m, Po pojawieniu się numeru, 
wpisujemy tekst (używając w razie potrzeby znaków sterują- 
cych), który kończymy znakiem ENTER, Wyjście z tego trybu 
następuje „o naciśnięciu EDIT. Gdy numer wiersza. przekro- 
czy 72707, automatycznie nastąpi wyjście z trybu wstawia- 
nia, 
Jesli, pisząc tekst, dojdziemy do końca programu i bufor 


nie zostanie zapełniony (wielkość bufora wynosi 64 znaki), 


to ekran zostanie przesunięty w górę umożliwiając dalsze 
pisanie. Tekst jest formatowany tak, aby numery wierszy 


były odzielone od tekstu. 


Listowanie tekstu programu 
dekst można przeglądać przy użyciu komendy "L"; liczba li- 


nii ekranu wyświetlanych na raz jest z góry ustalona, ale 


można ją zmieniać za pomocą komendy "K". 


Komenda: L n,m 
Listowanie tekstu programu na ekranie od wiersza n do m 
włącznie. Gdy argumenty nie są podane, n zawsze równa się 1, 
a m = 32767, czyli wartości nie zależą od poprzednich. 
Cały program można więc wylistować używając komendy L bez 
argumentów. Linie są formatowane do lewego marginesu tak, 
że numery wierszy są wyraźnie widoczne. Automatyczna tabu- 
lacja tekstu powoduje oddzielenie różnych pól w linii, 
Po wyświetleniu ustalonej ilości linii (patrz: komenda "K") 
listing jest wstrzymywany aż do naciśnięcia dowolnego 


klawisza - oprócz EDIT, Który powoduje powrót do edytora, 


Komenda: W n,m 
Listowanie tekstu programu między wierszami n a m na dru- 


karce. Pozostałe szczegóły identyczne jak w komendzie "L", 
Komenda: K n 


Ustala ilość linii ekranu wyświetlanych na raz, jak opisa- 


no w komendzie "L" powyżej. 


Edycja (redagowanie) tekstu 


Po wprowadzeniu pewnej ilości tekstu często zachodżi po= 


trzeba edycji niektórych wierszy lub fragmentów programu, 
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Opisane poniżej komendy służą do dokonywania poprawek, usu- 


wania, przesuwania i przenumerowywania wierszy, 


Komenda: N n,m ky 
Użycie komendy "N" powoduje przenumerowanie wszystkich wier- 
szy w programie. Pierwszy wiersz otrzymuje numer n, każdy 
następny o m większy od poprzedniego. Obydwa argumenty muszą 
być podane aby komenda została wykonana. Jeśli przekroczona 
zostanie wartość 32767, wówczas przywracana jest pierwotna 


numeracja. 


Komenda: M n,m 
Powoduje przepisanie treści wiersza o numerze n w wierszu o 
numerze m; zastępuje ewentualnie już istniejący wiersz m. 
Wiersz n pozostaje nie zmieniony. Jeśli wiersz o numerze n 


nie istnieje, komenda nie zostanie wykonana. 


Komenda: D n,m * 
Usuwa wiersze od numeru n do m włącznie z tekstu programu. 
Komenda zostanie wysonana gdy podane są obydwa argumenty, 
pod warunkiem, że nym - ma to na celu uchronienie użytkow= 
nika przed pomyłką. Pojedynczy wiersz można usunąć z pro= 
gramu za pomocą komendy D, gdy n = m lub wpisując po prostu 


-numer wiersza i ENTER» 


Komenda: F n,m,f,s 
Umożliwia odszukanie łańcuchów f w tekście programu między 
wierszami n a m i ewentualnie zastąpienie ich przez łań- 
cuch s. Tekst między wierszami n a m jest przeglądany w po- 
Szukiwaniu łańcucha znaków f. Jeżeli taki łańcuch zostanie 
odnaleziony, wtedy wiersu, w którym znajduje się dany łań= 


cuch jest wyświetlany (z kursorem umieszczonym na początku 
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łańcucha i następuje automatyczne wejście do trybu edycji, 
W-trybie tym można zastąpić łańcuch f łańcuchem s lub Ko- 
rzystać z innych komend trybu edycji - patrz: komenda E. 


Komenda: E n * 


Przesyła wiersz o numerze n do edycji, Jeśli taxi wiersz 
nie istnieje, komenda nie jest wykonywana, w przeciwnym 
wypadku wiersz ten jest kopiowany do bufora i wyświetlany 
na ekranie wraz z numerem, Poniżej jest wyświetlany ponow= 
nie numer wiersza i następuje wejście do trybu edycji, 
Wszelkie zmiany są dokonywane w buforze a nie na oryginal- 
"nym tekście, dlatego też w każdej chwili można przywrócić 
pierwotną treść wiersza. 

W tym trybie możemy przesuwać kursor wzdłuż wiersza (roz- 
poczynając od pierwszego znaku) aby w odpowiednim miejscu 
wykonać jedną z poniższych komend trybu edycji: 

" u (spacja) przesuwa kursor o jedną pozycję w prawo (do 


następnego znaku); nie można przesunąć kur- 
sora poza Koniec wiersza. 


CS 8 przesuwa kursor do następnej pozycji tabu= 
latora ale nie poza koniec wiersza, 

DELETE przesuwa kursor w lewo (do poprzedniego 
znaku), nie można przejść poza pierwszy 
znak w wierszu. 

EKTSR kończy edycję wiersza z zachowaniem wszyst- 
kich dokonanych zmian. 

Q przerywa edycję, tzn. opuszcza tryb edycji 
nie uwzględniając żadnych dokonanych zmian 
i pozostawiając wiersz pierwotny. 

R ładuje do bufora oryginalny wiersz, ignoru- 


jąc dokonane zmiany i pozostaje w trybie edycji, 
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listuje pozostałą część wiersza znajdującego 
się. w edycji (na prawo od bieżącej pozycji 
kursora), Wiersz pozostaje w trybie edycji z 
kursorem przesuniztyw na początek wiersza, 


Usuwa znak z aktualnej pozycji kursora. 


usuwą wszystkie znaki od aktualnej pozycji 
kursora do końca wiersza, 


szuka następnago miejsca występowania łańcu= 
cha f zdefiniowanego uprzednio (patrz: komen- 
da F). Powoduje automatyczne wyjście z trybu 
edycji (zachowując zmiany), o ile łańcuch f 
rie zostanie w tym wierszu odnaleziony. 
Jeżeli z kolei łańcuch ten zostanie odnale- 
ziomy w innym wierszu (w poprzednio określo- 
nym przedziale), nastąpi wejście do trybu 
edycji dla tego wiersza. Kursor jest zawsze 
umieszczany na początku odnalezionego łańcu- 
cha f. 


aktualnie odnaleziony łańcuch f zostaje zas- 
tąpiony uprzednio zdefiniowanym łańcuchem s, 
po czym wykonywana jest komenda "F" trybu 
edycji. Komendy "F" i "S" stosowane są do , 
przeszukiwania tekstu prosramu w celu odnale- 
zienia wszystkich łańcuchów znaków f i ewen- 


tualnie zastąpienia ich łańcuchem s. 


Wejście w tryb zmiany znaków, Sygnalizowane 
jest to zmianą kursora na [+] . Wpisanie dowol- 
nego znaku spwoduje zastąpienie znaku, na 
którym znajduje się kursor znakiem wpisanym 

i przesunięcie kursora o jedną pozycję». DELETE 
przesuwa kursor w lewo a CS 8 jest ignorowane. 
Po naciśnięciu ENTER nastąpi powrót do trybu 
edycji z kursorem umieszczonym za ostatnim 
zmienionym zakiem, 


wejście w tryb wstawiania znaków, Kursor zmie- 
ni się na fs]. Wpisywane znaki są wstawiane na 
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bieżącą pozycję kursora. DELETE powoduje skaso- 
wanie jednego znaku na lewo od kursora, a CS 8 

przesunięcie kursora do następnej pozycji tabu- 
latora dopisując spacje. Podobnie jak w trybie 

zmiany, po naciśnięciu ENTER nastąpi powrót do 

trybu edycji z kursorem umieszczonym po ostat= 

nio wpisanym znaku, k 


x Ustawia kursor na końcu wiersza z automatycznym. 
wejściem w tryb wstawiania znaków (I). 


Asemblacja i wykonywanie programu z edytora 


Komenda: A 
Wywołuje asembler GENS3M21, Szczegóły dotyczące asemblacji 


podane zostały w rozdziale 2, 


Komenda: R 
Jeśli asemblacja była bezbłędna oraz został podany adres wy- 
konania za pomocą dyrektywy asemblera ENT (patrz: rozdział 2.7) 
wtedy «omenda "R" może zoBtóĆ: użyta w celu wykonania kodu 
wynikowego. Jeżeli chcemy powrócić do edytora po wykonaniu 
kodu, należy umieścić w programie rozkaz RET (+C9). Oczywiś- 
cie powrót taki będzie możliwy pod warunkiem, że stos w mo- 
mencie wykonywania rozkazu RET będzie taki sam jak na po- 
czątku pro,ramu. Dyrektywa RET nie działa, tzn. wykonanie 
kodu za o0moc4 komendy "R" nie jest możliwe, jeśli wybrana 


została opcja numer 16, 


Współpraca z magnetofonem 

Komenda: P n,m,s 
Umożliwia zapisanie tekstu między wierszami n a m włącznie, 
na taśmie pod nazwą zdefiniowaną łańcuchem s. Przed wprowa- 
dzeniam komendy należy włączyć magnetofon - ładowanie rozżpo-= 


czyna się z chwilą naciśnięcia ENTER, 
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Komenda: G,,5 
Na taśmie odszukiw:'ny jest zbiór o nazwie s, po czym jest 
on ładowany do pamięci komputera, Można również użyć komen= 
dy G w celu załadowania pierwszego napotkanego na taśmie 
zbioru. Po wprowadzeniu komendy pojawi się napis "Start 
tape ..." (włącz taśmę). Komunikat "Found nazwa” oznacza 
odszukanie zbioru o innej, niż podana, nazwie, a "Using 
nazwa" - ładowanie zbioru do pamięci. Błąd w trakcie łado- 
wania sygnalizowany jest komunikatem "Tape error!". 
Uwaga: jeśli w pamięci znajduje się już jakiś tekst, to 
program, Który jest ładowany z taśmy zostanie do niego do= 
łączony a całość przenunerowana poczynając od 1 z krokiem 1% 
Komenda: T n,m,s 
Powoduje zapis tekstu od wiersza n do m włącznie w postaci 
umożliwiającej późniejsze włączenie do innego programu za 
pomocą komendy asemblera e! (patrz: rozdział 2.9). Przed 


naciśnięciem *NTER należy włączyć taśmę, 


Inne komendy 

Xomenda: B 
Powrót do systemu operacyjnego ZX Spectrum. Szczegóły doty- 
czące ponownego wejscia do progrmau GENS3M21 oraz GENS3 


omówiono w rozdziale 1, 


Komendą: C 
Dokonuje konwersji tekstów napisanych za pomocą edytora 
GENS1 na format używany przez GENS3M21, Tekst przeznaczony 


do konwersji należy załadować z taśmy za pomocą komendy "G", 


ńomenda: S,,d 


Ta «omenda pozwala zmienić sevarator oddzielający argumenty 
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w komendach edytora. Wstępnie, rolę separatora pełni "ge", 
Po tej komendzie separatorem będzie pierwszy znak łańcucha d; 
musi on być stosowany we wszystkich somendach (navet w "g") 
dopóki nie zdefiniujemy nowego. 
Spacja nie może być separatorem, 
Przykład: 
S,,! nowym separatorem stanie się "!" 
S!!, z powrotem ",„" 
Komenda: V 


Wyświetla aktualne wartości argumentów N1,N2,S1 i S2. 


Komenda: X 
Wyświetla początkowy i końcowy adres tekstu programu, 
Możemy wykorzystać te informacje aby nagrać tekst z Basica: 
za pomocą zlecenia: 
SAVE "nazwa" CODE ap,ak+1-ap 
gdzie: ap - adres początkowy, 
ak - adres końcowy» 
Końcowy adres tekstu programu pozwoli nam też obliczyć ilość 


wolnej pamięci. 


Edytor GENS3M21 może pracować z tekstem wpisanym przez użyt- 
kownika, nagranym z taśmy lub wygenerowanym w inny sposób, 

na przykład przez program MONS3M21 (patrz: instrukcja do prog= 
ramu MONS3M21, komenda "T", rozdział 2,2), W tym ostatnim 
przypadku, wygenerowany tekst należy umieścić od adresu po- 
czątkowego podawanego przez komendę "X", a następnie wpisać 
adres końcowy (podany przez komendę "T" programu MONS3M21 lub 
obliczony na podstawie długości tekstu) do komórki TEXTEND 

o adresie "początek programu GENS3M21 + 54"; w końcu wejść 


do programu GEN5S3M21 via ciepły start (patrz: rozdział 1). 


3,3 Przykład użycia edytora 


Przypuśćmy, że napisaliśmy następujący program (używając 
komendy I10,10): 


10 sh liczby losowe 16-bitowe 


20 

30 ; We - poprzednia liczba losowa w HL 
40 ; Wy = nowa liczba losowa w IIL 

50 

60 LOS PUSH AF ; zachowaj rejestry 
70 PUSH BC i 
80 PUSH HL 

30 ADD HL,HL ; »2 

100 ADD HL,HL ; »4 

110 ADD HL,HL ; «8 

120 ADD HL,HL 3 «+16 

130 ADD HL,HL 3; «32 
140 ADD HL,HL ; «64 

150 ADD HL,HL ; «128 

160 PIP BC ; poprzednia liczba 
170 ADD HL,DE 

180 LD  DE,41 

190 ADD HL,DE 

200 POP BC 

210 POP AF 

220 RER 


W programie są następujące błędy: 

wiersz 10 - komenda asemblera napisana małą literą 

wiersz 80 - mnemonik w polu etykiet 

wiersz 160 - "PIP" zamiast "POP" 

wiersz 220 — "RER" zamiast "RET" 
"Poza tym powinien być dopisany dodatkowy wiersz z rozkazem 
ADD HL,HL po wierszu 150 oraz rejestry między wierszami 170 


a 190 powinny zostać zamienione (BC zamiast DE). 
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Tekst programu możemy poprawić w sposób następujący: 


E10 ENTER następnie _ (spacja) C€ (tryb zmiany) 
H ENTER ENTER 

E80 ENTER I (tryb wstawiania) CS 8 (znak tabulatora) 
ENTER ENTER 

155 CS 8 ADD CS 8 HL,HL C8 8 ; « 256 ENTER 


E160 ENTER CS. 8 _ (spacja) C (tryb zmiany) O 
ENTER ENTER 

F170,190,DE,BC S (zamiana łańcucha DE przez BC) S S 

E190 ENTER X _; «257+41 ENTER ENTER 


dopisaliśmy komentarz do wiersza 190 
E220 ENTER X DELETE T ENTER ENTER 


N10,10 przenumerowujemy tekst 


ROZDZIAŁ 4. PRZYKŁAD PRACY Z PROGRAMEM GENS3M21 


Poniżej podany został typowy przykład pracy z programem 
GENS3M21. Zaleca się dokładne .przestudiowanie tego przykładu 
użytkownikom, którzy nie pisali jeszcze programów w kodzie 


maszynowym lub nie są pewni jak korzystać z programu GENS3M21, 


Przykład pokazuje proces kodowania programu mnożącego dwie 
liczby 16-bitowe, uruchamiania tego programu i zapisywania 

na taśmie przy użyciu komendy "T" tak, aby można go było włą— 
czać do innych programów, Tekst programu przed uruchomieniem 
powinien zostać nagrany na taśmie za pomocą komendy "P", aby 
nie trzeba go było przepisywać ponownie w razie przypadkowego 


zniszczenia, 


Załóżmy, że program GENS3M21 został wczytany za pomocą prog- 
ramu ładującego "G/M 3M21", czyli od adresu 37000, 

ETAP I - pisanie tekstu programu 

Użyjemy komendy I edytora do wpisywania tekstu oraz =»(CS 8) 
przed mnemonikiem i między mnemonikiem a argumentami. Adresy 
pokazane w przykładzie służą jedynie jako ilustracja i mogą 


nie zgadzać się z otrzymanymi podczas asemblacji na konkretnej 


maszynie. 
>I10,10 ENTER 
10 ; procedura mnozoca ENTER 
20 ; mnozy DE przez BC ENTER 
30 ; wynik umieszcza w DE HL ENTER 
40 ENTER 
50 MNOŻ _ ENTER 
60 LD HL,O ENTER 
70 LD A,16 ; licznik bitów ENTER 


80 PETLA ADD HL,HL ENTER 
30 BX  DE,HL ENTER 
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100 ADC HL,HL ENTER 
110 EX  DE,HL ENTER 

120 JR _ WO,NAST ENTER 

130 ADD HL,BC ENTER 

140 JR  NC,NAS ENTER 

150 INC DE ENTER 

160 NAST DEC A ; zmniejsz licznik bitow ENTER 
170 JR  NZ,BETLA ENTER 

180 RET ENTER 

190 EDIT 


>P10,180,MNOZENIE ENTER 


Przed naciśnięciem ENTER w komendzie "P" należy włączyć taśmę, 
ETAP II - uruchamianie programu 


Najpierw sprawdzimy czy asemblacja przebiega prawidłowo. 
Wybierzemy opcje 2 i 4 aby asembler nie generował kodu wyniko= 
wego i nie wyświetlał listingu. 

DA ENTER 


Table size: ENTER 
Options: 6 ENTER 


wHISOFT GENS35M2 ASSEMBLER 
ZX SPECTRUM 


Copyright (C) HISOFT 1983,4 
A1l rights reserved 


Pass 1 errors: 00 


Pass 2 errors: 00 

*WARNINGe NAS absent 

Table used : 47 from 131 

> 

Jak widać, popełniliśmy błąd w wierszu 140 pisząc NAS zamiast 


NAST. Poprawiamy błąd: 


>E140 ENTER 
140 JR  NC,NAS 


140 [C) 


=.30=— 


naciskamy X 

140 JR  NC,NAS(B 
i wpisujemy brakującą literę T. Po dwukrotnym naciśnięciu 
ENTER poprawiony wiersz zostanie wstawiony do programu, 


Kolejna asemblacja powinna być bezbłędna, 
Napiszemy teraz program testujący naszą procedurę: 


>N1000,10 ENTER (przenumerowujemy tekst zaczynając od numeru 
1000, aby wpisać nowy tekst na początku) 


>I10,10 ENTER 
10 ; program testujący ENTER 
20 ; procedure mnozenia ENTER 


30 ENTER 

40 LD _. BC,(MNOZNA) ENTER 
50 LD  DE4(MNOZNIK) ENTER 
60 CALL MNOZ ENTER 
70 LD A,D ENTER 
80 CALL PISZ_A ENTER 
90 LD A,E ENTER 
100 CALL PISZ_A ENTER 
110 LD A,H ENTER 
120 CALL PISZ_A ENTER 
130 LD A,L ENTER 
140 CALL PISZ_A ENTER 
150 RET ENTER 

160 ENTER 

170 PISZ_A PUSH AF ENTER 

180 RRCA ENTER 

190 RRCA ENTER. 

200 RRCA ENTER 

210 RRCA ENTER 

220 CALL DALEJ ENTER 
230 POP „AF ENTER 

240 DALEJ AND %1111 ENTER 
250 "ADD A,490 ENTER 


260 DAA ENTER 
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270 ADC 4,440 ENTER 
280 * DAA ENTER 

290 LD  IY,45C3JA ENTER 
300 RSR 16 ENTER 

310 RET ENTER 


320 MNOZNA DEFW 1000 ENTER 
330 MNOZNI DEFW 50 ENTER 
340 eE ENTER 


350 EDIT 
> 


Teraz możemy przeprowadzić asemblację procedury testującej i 
mnożącej żącznie: 
>A ENTER 


Table size: ENTER 
Options: 6 ENTER 


«HISOFT GENS3M2 ASSEMBLERe 
ZX SPECTRUM 


Copyright (C) HISOFT 19867,4 
All rights reserved 


B69F 300 RSR 16 
+ERRORe 02 (nacisnij dowolny klawisz) 


Pass 1 errors: 01 


Table used: 98 from 101 
> 


W pierwszym przebiegu asemblera został wykryty jeden błąd - 
powinno być RST zamiast RSR. Poprawiamy błąd: 
>E300 ENTER 
300 RSR 16 
300 [G) 
Przesuwamy kursor (klawisz SPACE) na literę "R" i naciskamy C 
- tryb zmiany znaków 
300 RSH T ENTER ENTER 
> 
Dokonujemy ponownie asemblacji i jeśli jest prawidłowa, może 


my wykonać nasz program. Przedtem jednak musimy wskazać miejace 
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(adres), od którego edytor ma zacząć wykonywać kod, Wpisujemy 
wiersz: 

35 ENT $ ENTER 

Teraz, po asemblacji (w odpowiedzi na Options: naciskamy 
ENTER), wyświetlony zostanie dodatkowy komunikat: 

Executes: 46718 


Wykonujemy program za pomocą komendy "R": 
DR ENTER 
0000E15A > 


4B15A równa się 50000 (1000w 50) - program możemy przetesto- 
wać również dla innych liczb. Wystarczy wpisać inne wartości 

w wierszach 320 i 330, Przed wykonaniem programu, gdy w tekś- 
cie zostały zrobione jakiekolwiek zmiany, nałeży przeprowadzić 
ponowną asemblację» 

Kolejną czynnością będzie nagranie procedury na taśmę tak, aby 


można ją było włączać do innych programów: 
>T1000,1500,MNOZ ENTER 


Przed naciśnięciem ENTER należy włączyć taśmę, Tak nagraną 
procedurę możemy wykorzystywać w innych programach w następu= 
jący sposób, np.: 

500 ; włącz procedurę MNOZ 

510 wF MNOZ 

520 ; następne procedury 

Gdy podczas asemblacji pojawi się napis "Start tape...", należy 
włączyć taśmę z nagraną procedurą MNOZ. Czynność tę należy pow 


tórzyć również w drugim przebiegu asemblera. 


ZAŁACZNIK 1.  O'IS BŁĘDÓW 


*ERROR« 1 błąd w składni danego wiersza 


*ERROR« nierozpoznany mnemonik 


symbol zdefiniowany więcej niż jeden raz 


2 

*ERROR* 3 nieprawidłowo sformułowany rozkaz 
*ERROR* 4 
5 


*ERRORs ten wiersz zawiera nieważny znak, tzn. znak, 


który nie jest ważny w tym kontekście 


«ERROR«* jeden z argumentów rozkazu jest nieprawidłowy 


*ERROR= symbol w tym wierszu jest słowem zastrzeżonym 


zbyt wiele rejestrów w tym wierszu 


6 

1 
«*ERRORw 8  niedopasowane rejestry 

«*ERROR« 9 

O 


*EuROR* 1 wartość wyrażenia, które powinno być 8-bitowe, 
ma więcej niż 8 bitów 

«BRRORe 11 rozkazy JP IX+n oraz JP If+n są nieważne 
*ERROR= 12 błąd w sformułowaniu dyrektywy. asemblera 


*BRROR= 13 nieprawidłowe odniesienie w przód, tzn. wyrażenie 
w EQU zawiera niezdefiniowany symbol 


»EBRROR* 14 dzielenie przez zero 


«VDRROR* 15 nadmiar w operacji mnożenia 


Bad Org! wartość wyrażenia ORG jest taka, że generowany kod 
wynikowy mógłby spowodować zniszczenie programu 
GJNS3M21, tekstu programu użytkownika lub tablicy 
symboli. Sterowanie przekazywane jest do edytora 


Bad Memory! nie ma miejsca w pamięci na więcej tekstu programu, 
Należy zapisać na tasmę cały tekst lub jego część 
Tape error! bł.d we wczytywaniu z taśmy 
No Table Space! 
za mały obszar pamięci został przeznaczony na Tab- 


licę Symboli (w odpowiedzi na "Table size:"), 
Sterowanie przexazywane jest do edytora 


ZAŁACZNIK 2. 
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SŁOWA ZASTRZEŻONE, MNEMONIKI, DYREKTYWY I 


KOMENDY: : ASEMBLERA 


Słowa zastrzeżone nie mogą być używane jako etykiety ale mogą 


stanowić część etykiety, . Wszystkie słowa zastrzeżone są pisa 


ne wielkimi literami, 


Lista słów zastrzeżonych: 


A 
AF 


SRA 


Lista 
DEFB 
END 


Lista 


*D 
«F 


B [ej 

AF" 

IY 

P 
mnemoników Z80: 
ADD AND BIT 
CPIR CPL DAA 
HALT IM IN 
JR LD LDD 
OTDR OTIR OUT 
RETI RETN RL 
RRC RRCA RRD 
SRL SUB XOR 


D 

BC 
SP 
PE 


CAL 
DEC 
INC 
LDDR 
OUTD 
RLA 
RST 


dyrektyw asemblera: 


DEFM 
ENT 


komend asemblera: 


*E 


DEFS 
EQU 


xH 


E H L 
DE HL. 
Z NZ 
PO 

CCR CP GPD 

DI DJNZ  EI 


IND INDR  INI 
LDI LDIR  NEG 
OUTI POP _ PUSH 
RLC RLCA  RLD 
SBC SCF _ SET 


DEFW ELSE 
IF ORG 


*L «S 


CPDR 
EX 
INIR 
NOP 
RES 
RR 
SLA 


aC 
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Część II 


MONSZJM2I 


MONITOR I DrB'GGEK 


ROZDBIAŁ 1. URUCHOMIENIE PROGJAMU 


MOŃS3M21 można załadować w dowolne miejsce w pamięci. Długość 
programu wynosi 6068 bajtów (MONS3 - 5760), łącznie z własnym, 
wewnętrznym stosem. Jeśli użyjemy oryginalnego programu ładu- 
jącego "G/M 3M21", MONS3M21 zostanie załadowany od adresu 
30000, Chcąc umieścić program w innym miejscu (np. pod konisc 
pamięci), należy wprowadzić następujące komendy : 


CLEAR 59467 
LOAD "MONS3M21" CODE 59468 
RANDOMIZE USR 59468 


Ostatnia komenda to skok do adresu 59463, czyli do miejsca, 
od którego program został załadowany. Skok do tego miejsca wy- 
konujemy zawsze, gdy chcemy uruchomić program ponownie, tzn. 


po powrocie do systemu operacyjnego ZX Spectrum, 


Pro.ram MONS3 ładujemy i uruchamiamy w ten sam sposób, ale 
ponowne wejście do programu może nastąpić, poprzez skok do 
adresu o 29 większego. Na przykład, po załadowaniu MOiS3 
od adresu 40000, piszemy: 
RANDOMIZE USR 40000 za pierwszym razem 
RANDOMIZE USR 40029 za każdym następnym razem, 
gdy chcemy uruchomić program. 
Po wejściu do programu MONS3M21 ukazuje się na kilka sekund 
napis "HOHNSJM2 Debugger © Hisoft 1983,4%, a następnie tak 
zwena "tablica MONS3" (patrz: załącznik "Tablica MONS3"), 
Na tablicy u<azane są zawartości wszystkich rejestrów oraz zna» 
czniki stanu mikroprocesora 230; 24 bajty „amięci wokół Wskaź- 
nika Pamięci (oznaczonego -na tablicy znakami:> €) óraz zapis 


szmboliczny rozkazu, adresowanego przez dskaźńik Pamięci. 
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Adresy pamięci, zawartości rejestrów oraz komórek pamięci są 
zapisane w systemie szesnastkowym. System zapisu adresów pa- 
mięci oraz zawartości rejestrów (oprócz AF i IR) możemy za- 
mienić na dziesiętny za pomocą komendy 4 (SYMBOL SHIFT 3). 
Komendy wprowadzamy w odpowiedzi na znak ">", znajdujący się 
w dolnej części ekranu. Komendy można wprowadaać małymi lub 
wielkimi literami, niektóre z nich wymagają użycia CAPS SHIFT 
(Cs) lub SXMBOL SHIFT (SS). 

Liczby podawane w komendach (oprócz komendy H) muszą być w 
systemie szesnastkowym. Możemy wprowadzić dowolną ilość cyfr 
szesnastkowych (0-9, A-F lub a-f) i zakończyć ten ciąg dowol- 
nym innym znakiem (DELETE kasuje ostatnią cyfrę), 

Jeśli znakiem kończącym jest "=" (minus), to liczba jest trak- 
towana jako ujemna - w kodzie U2 (np. 1800- równa się E800), 
Tylko ostatnio wpisane cztery cyfry są wyświetlane na ekranie, 
Komendy wykonywane są natychmiast = nie potrzeba naciskać 
ENTER. Po wykonaniu każdej komendy, cała tablica jest uake 
tualniana. Nieważne komendy są ignorowane, 

W dowolnym momencie można wrócić do systemu operacyjnego 

ZX Spectrum naciskając EDIT ( CAPS SHIFT 1). 

UWAGA: MONS3M21 wyłącza przerwania aby zapewnić prawidłową pra- 
cę - użytkownik powinien uważać, aby nie włączać przerwań 


"rozkazem EI) podczas pracy z pro.:ramem, 
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ROZDZIAŁ 2. KOMENDY 


2.1 Ustawianie Wskaźnika Pamięci 


M 


ustawia Wskaźnik Pamięci na podany adres. 


Adres wprowadzamy w systemie szesnastkowym w odpowiedzi na 
n;", np.: 


M:E43A 


ENTER 
zwiększa Wskaźnik PamTęci o jeden 


CAPS SHIFT_8 Lub SYMBOL SHIFT_2 


zwiększa Wskaźnik Pamięci o osiem 


CAPS SHIFT 7 
ZMNIS8JSZA Wskaźnik Pamięci o jeden 


CAPS SHIFT_5 


zmniejsza Wskaźnik Pamięci o osiem 


<A 


ustawia Wskaźnik Pamięci na adres skoku bezwzględnego 
(JP lub CALL) 


Komenda X ustawia Wskaśnik Pamięci na adres wskazywany przez 
Wskaźnik Pamięci (mniej znaczący bajt) i Wskaźnik Pamięci + 1 


(bardziej znaczący bajt). Patrz przykład w komendzie V. 


V 


używana w połączeniu z xomendą X 


V powoduje ustawienie Wskaźnika Pamięci na adres sprzed ostat- 
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nio wykonanej t:omendy X. Przykład użycia «omend X i Y: 


COW2 Bz 
>COF3 CC 4 CALL Z,%CA47 
Z0F4 47 
COv5 CA 
COF6_ 19 


w adresie COF3, wskazywanym przez Wskaźnik Pamięci, znajduje 
się rozkaz CALU Z,wCA47., Przesuwamy Wskaźnik o jeden ( komen= . 


da uNTER) tak, aby ws<azywał na adres podprograniu: 


COF2 BB 
:00F3 CG 

> COF4 47 < 
COF5 CA 
CJF6 19 


i naciskamy X: 


CA46 C9 

> CA47 01 < 
CA43 EA 
CA49 FF 
CA50 21 


Wskaźnik Pamięci jest ustawiony na udres CA47. Po obejrzeniu 
podorogramu, inożemy wrócić do programu głównego naciskając V - 
- Wskażnik Pamięci bądzie wskazywał adres COF4, 

Za pomocą kom.'ndy V można wrócić do adresu sprzed ostat:io 
wykonane j komendy 4; wszystkie wcześniejsze adresy, z których 
zostały wykonane komendy X są wymazane z pamięci proramu 


MONŻJ, 


O 


ustawia Wskaźnik Pamięci na adres skoku względnego (JR lub 


LJKZ). 


Wykonanie komendy O pole. i: nec dodaniu do wartości Wskaźnika 
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Pamięci zawartości komórki pamięci wskazywane j przez Wskaź- 
nik, umieszczeniu wyniku we Wskaźniku Pamięci oraz odpowied- 


niej zmianie tablicy HONS3. Patrz: przykład w komendzie U. 


U 


używana w połączeniu z komendą O. 


U powoduje ustawienie Wskaźnika Pamięci na adres sprzed os- 


tatnio wykonanej komendy 0. Przykład użycia komend O i U: 


DA49 QD 
D> DA4ĄA 23 A JR NZ,*DA4E 
DA4B 02 
DAĄC 51 
DA4D CI 


W adresie LA4A, wskazywanym przez Wskaźnik Pamięci, znajduje 
się rozkaz JR NZ,*DA4E. Przesuwamy Wskaźnik o jeden (ENTER) , 


tak, aby wskazywał wiekkość przesunięcia względnego (+02): 


DA49 OD 
DA4A 23 
> DA4B 02 < 
DAĄC BI 
DA4D 09 
DA4E 29 
DAĄP AC 
DA50 1F 


Po naciśnięciu O do adresu we Wskaźniku Pamięci (%+DA4B), 
zostanie dodana zawartość komórki adresowanej przez Wskaźnik 


(+02) oraz 1. 


DA4D CJ 

> DAĄE 29 < 
DA4F AC 
DA50 1P 


Za pomocą komendy U możemy wrócić do adresu sprzed ostatnio 
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wysonanej 'omendy 0. (w powyższym przykładzie 4*DAL4B), 


la. (przecinek) 
Ustawia Wska.nik Pamięci na adres znajdujący się na stosie 


(wskazywany przez wskaźnik stosu - SP), 


Komenda jest stosowana, gdy chcemy poznać zawartość pamięci 
wokół adresu powrotu z podprogramu, Komenda ta jest często 


używana w połączeniu ż «omendą 55 x, 


2.2 Deasemblacja kodu 


SYMBO CHINT 4 $ 
dokonuj” deasemblacji kodu od adresu wskazywanego przez 


Wskaśnik Pamięci. 


Po naciśniyciu © 4 tablica M iiil3 zostaje zastąpiona wydru= 
kier o następującej postaci: 


adres zawartość komórex pamiyci symboliczny 
tworząca 1 rozkaz zapis rozkazu 


Po naciśnięciu dowolnego klawisza zostaną wyświetlone nas- 
tępne rozkazy, zajmujące około 20 bajtów pamięci, Ponowne 
naciśnięcie 88 4 spowoduje powrót do tablicy MONS3, 


Zobaiez również: komenda SS 3 w rozdziale 2,8, 


i 
dokonuje deasemblacji bloku kodu z możliwościę wyprowadzenia 
wydruku na drukarkę oraz wygenerowania tekstu w formie umoż= 


liwiającej używanie o przez edytor pro, ramu GENS3M21, 


Adresy poczi,tku i końca bloku podajemy w odpowiedzi na 


tyirst:" (adres pierwezago bajtu) i "*Last:" (adreu ostatnie= 
go bajtu). Komendz nie zostanie wykonana jeśli adres por 
czątku jest większy od adresu końca, Poe wpiaaniu adresów 
pojawi się pytanie "Printer?" (drukarka) - należy opowie” 
dzieć "y" (tylko wielka litera), aby skierować tekst na 
drukarkę. Następnie wyświetlony zostanie napis "Text:", po 
którym wprowadzamy adres początkowy pod Jaxim chcemy unieś 
cić tekst deasemblacji. Wciśnięcie ENTER bez adresu Gpowo” 
dujs, że tekst nie zostanie wygenerowany. Jeśli wpiszemy 
adres, tekst deasemblacji, w formie unożliiwiającej używanie 
go przez edytor prozramu GENS3M21, zostanie umieszczony 
począwszy od tego adresu, Użycie tekstu w proenamie GZNS3N21 
będzie możliwe, jeśli tekst zostanie wygenerowany lub prze= 
suniyty (patrz: komenda I) do adresu pudanego przez komendę 
nyv edytora GLNS3M21 (tzn. tam, gczie edytor umieszcza tekst 
programu użytkownixa). 

Po wyżenerowaniu tekstv we wtaściwym misjscu a przed wejś- 
ciem do programu GELS5M21 należy wpisać adres końca tekstu 
do komórki TEXTLND, zaajdującej się w programie GENSZMŻi 
(patrz: instrukcja do programu GENS3M21, rozdział 3,2), 
Adres końca te<stu zortanie podany po wykonaniu komendy T 

w komunikacie "Text end=" (patrz niżej), 

MONSZM21 sp:awdza czy generowany tekst nie zachodzi na sóż 
gram MUN. 3M21; w przypadku zaistnienia takiego niebezpie- 
czeństwa, wykonywanie kowendy T jest przerywane - po naciś- 
nigciu dowolrego klawisz: nastąpi powrót do tablicy MoNS3, 
Pec podaniu adresu w odpowiedzi na "Text:", pojawi się napis 
WorssJace:", po którym należy poiać adres początku wolnego 
obszaru a pamięci, który zostanie użyty jako tablica gym 


bożi, Fatxwzebnz wielkośc pamięci wynosi 2 bajty razy ilość 
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etykiet generowanych podczas deasemblac ji (patrz niżej). 
Jeśli wciśniemy ENTER, tablica symboli będzie tworzona od ad- 
resu 46000 (24576). 
Jeśli w bloku kodu przeznaczonego do deasemblacji znajdują 
się obszary danych (nie zawierające rozkazów Z80), to należy 
podać adresy początku i końca każdego z tych obszarów, w od 
powiedzina "First:" i "Last:", a po zdefiniowaniu wszystkich, 
wcisnąć dwa razy ENTER. Dla obszarów danych zostaną wygene= 
rowane dyrektywy asemblera DEFB (patrz: instrukcja do pro- 
gramu GENSZM21 - rozdział 2,7 ) oraz odpowiednie znaki w ko- 
dzie ASCII. Ponieważ adresy definiowanych obszarów są prze- 
chowywane na końcu programu MONS3M21, możemy zdefiniować ty- 
le obszarów danych, ile jest wolnej pamięci w programie 
MONS3M21, Uwaga: komenda T niszczy wszystkie uprzednio wpisa- 
ne adresy powrotu - patrz: komenda W, 
Gdy wszystkie dane zostaną wpisane, następuje wymazanie e- 
kranu i po chwili przerwy, w czasie której generowana jest 
tablica symboli, na ekranie lub drukarce ukazuje si, listing 
deasemblacji. Postać listingu jest taka jak w komendzie SS 4, 
z tym, że dołączone jest pole etykiet. Listing można zatrzy- 
mać naciskając ENTER lub SPACE, po czym naciśnięcie: 

CS 5 spowoduje powrót do tablicy MONS% 
a innego klawisza - kontynuację listingu 

Jeśli zostanie napotkany nieważny fórmat rozkazu, jest on 
tłumaczony jako N0P, a zawartość bajtu oznaczona znakiem '*?, 
Po zakończeniu deasembliacji, jeśli żądaliśmy generowania 
tekstu, wyświetlony zostanie komunikat "Text end = aa", gdzże 
aa jest adresem końca tekstu (dziesiętnie lub szesnastkowo), 


który nalezy wpisać do komórki TEXTEND w pro:ramie GENS3M21. 


Powrót do tublicy MONS3 nastąpi po naciónięciu dowolnego 
klawisza, 

Podczas deasemblacji tworzone są etykiety postaci Lxxxx, 
gdzie uxxxx" jest adresem w zapisie szesnastkowym. Etykiety 
są' tworzone tylko dla adresów leżących w granicach podanego 
obszaru, inne adresy są podawane w postaci liczb dziesięt= 
nych lub szesnastkowych. Na przykład, jeśli dokonujemy dea- 
semblacji kodu w granicach od *7000 do w800u, wtedy rozkaz 
o «odzie UAF574 zostanie zapisany w postaci: JP C,174F5, a 
np. rozkaz CC27E0 - jako CALL Z,%E027 lub CALL Z,57383, jeś- 
li adresy s:;; wyświetlane w zapisie dziesiętnym. Odpowiednie 
adresy, je>li jest odwołanie do nich, zostaną opatrzone ety> 
kictą (w polu etykiet, przed mnemonikiem), tylko w przypad> 
ku penerowania tekstu >roframu. 

rzykład użycia komendy T. 

Załóżmy, że program GoNS3M21 jest załadowany od adresu 
370006, tak więc adres pod którym edytor unieszcza tekst pro= 
gramu (uzyskany za. pomocą komendy X edytora) wynosi 45866 
(*BZ2:;.) 

T 


First: "FDP 
Last: FSFB 
Printer? ENTER 
Text: B32A 

nork svuce: £000 
rirst: FvPIJ 
Last: PPFR 


*irst: ENTBa 
Last: ENTER 


adres początku bloku kodu przeznaczonego 
d> deasemblacji 

adres xońca bloku 

tekst zostanie wyświetlony na ekranie 
adres początkowy, pod jakim chcemy umie*=- 
cić tekst deasemblacji 

adres początku wolnego obszaru w pamięci 
przeznac:onepo na tablicy symboli 

adres początkowy obszaru nie zawierające-- 
go rozkazów Zu0O 

adres «oiicow; te;zo obszaru 

koniec definiowania 
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PFDF A7 AND A 

FFEO 21 36 5C LD  HL,*3C30 
FFEŻ3 ED 58 4F 50 LD  DE,(*5C4F) 
FFE7 ED 52 SBC HL,DE 

PFE9 .23 INC HL 

SREA 22 IA 5C LL  (*5CIA),HL 
PFED 11 30 5C LD  DE,*5C30 
*FFO 21 P9 FP LD  HL,LEPF9 
FFF3 01 06 00 LD  BC,+0006. 
PFF6 ED BO LDIR 

EFPB C9 KET 

FPF9 56 PE C4 LFPF9 | DLYB "V",eFE,eC4 
PPFC 15 53 80 DEFB +15,"5" ,630 


Text end = *B3E4 
Adres końca tekstu, *Bjs4, musimy wpisać do komórki 
THXTEKD orogramu GsN03M21, Która znajduje siy pod adresem 
37094, 
Gamieniamy ten adres na postać szesnastkową (patrz: komenda 
H): 
H:37054 = JOBE 
i ustawiamy Wskaźn.« Pamięci na ten adres: 
M:90BE 
Możemy teraz wpisać adres końca tekstu, *B3E4, pamiętając 
aby mniej znaczący bajt wpisać najpierw: 


E4 ENTER E4 zostanie wpisane do adregu *%90BE 
i Wskaźnik Pamięci przesunie się o 1 
(patrz: rozdział 2,6) 

B3 SPACĘ wpisujemy B3 


Po wpisaniu ad:esu końca tekstu możemy wejść do programu 
GENG3M21 via ciepły start (patrz instrukcja do programu 
GiNs3M21 rozdział 1), 
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2.5 wykonywanie programów w kodzie wynikowym 


SYMBOL SHIFT Z 


wykonuje jeden rozkaz programu 


trzed użyciem komendy SS Z zarówno licznik rozkazów PC, jak 
i Wskaźnik Pamięci muszą być ustawione na adres rozkazu, 
który zamierzamy wykonać (patrz: rozdział 2,7). Np. : 


M:782D ustawiamy Wskaźnik Pamięci na adres 
*782D 
132De wpisujemy *782D do rejestru PC 


SS Z wykonuje bieżący rozkaz i uaktualnia tablicę MONS3, 
Za pomocą komendy :;S Z możemy wykonywać dowolgy program w 
RAM i KOM pod warunkieis, że nigdzie nie występuje rozkaz 


włączający przerwania (EI). 


Ra.IE 


wpisuje adres powrotu w miejscu wskazywanym przez Wskaźnik 
Pamięci, | 


Jest to komenda pomocnicza, używana najczęściej w połącze= 
niu z komendą SS K (patrz niżej). 

Adres powrotu to po prostu rozkaz CALL do podprogramu zaje 
mującego się wyświetlaniem tablicy MONS3, Wpisanie adresu 
powrotu umożliwia zatrzymanie wykonywania programu użyt= 
sownika w żąda:ym miejscu, w celu obejrzenia zawartości re- 
jestrów, stanu znaczników itd. Na przykłać, jeśli shosay za- 
trzymać wykonywanie programu w adiesie *E84E, to należy u- 
stawić Wskaźnik Pamięci na ten adres i nacisnąć W aby 
wstawić adres powrotu w im mie ,scu. 

3 bajty kodu, które znajdują się w adresach *E34E, *EB4F, 


*E350, zostaną zapisane w pamięci na koficu programu MONS3M21, 
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a na ich miejsce będzie wpisany rozkaz CALL z odpowiednim 
adresem. Gdy, podczas wykonywania programu użytkownika, z08- 
tanie napotkany powyższy rozkaz, oryginalne 3 bajty będą 
wpisane na swoje miejsce i zostanie wyświetlona tablica MONS3 
ze wszystkimi rejestrami 1 znacznikami sprzed momentu wyko» 
nania rozkazu CALL. 

Program MONS3M21 używa obszaru pamięci znajdującego się na 
końcu programu, do przechowywania informacji o wpisanych 
adresach powrotu. Oznacza to, że możemy wpisać tyle adresów 
powrotu ile jest dostępnej pamięci; na każde wykonanie ko= 
mendy W potrzebne jest 5 bajtów pamięci. Po wykonaniu roze 
'kazu CALL z adresem powrotu, automatycznie odtwarzana jest 
zawartość pamięci jaka była przed wpisaniem adresu powrotu, 
Uwaga: wytonanie komendy T, która używa tego sanego obszaru 
pamięci, spowoduje utratę zawartości tych komórek pamięci, 
w które zostały uprzednio wpisane adresy powrotu. 

Adresy powrotu mogą być wpisywane tylko do pamięci RAM, 
Ponieważ adres powrożu składa si, z trzy-bajtowego rozkazu 
CALL, należy zwrócić szczególną uwagę na miejsce jego wpie 
sania. Na przykład, w poniższym fragmencie: 


A400 1A LL A,(DE) 
A401 FE CP A,„*FO 
A402 FO E 
14403 28 JR Z,%A406 
X404 01 

"4405 AP XOR A 
440% 03 JP *43A3 
A407 A3 

1408 43 


Jeśli wpiszemy adres powrotu w %A405 i następnie zaczniemy 


wykonywać program od adresu A400, to do rejestru A zostanie 


Wpisana zawartość komórki pamięci adresowanej przez parę 
rejestrów DE. Jeżeli w wyniku porównania, znacznik Z zosta- 
nie ustawbony na 1, to wykonany będzie rozkaz skoku względ- 
nego do adresu *A406, Ale w komórce o adresie +A406 znajdu= 
je się teraz mniej znaczący bajt adresu rozkazu CALL; kod 
programu został zmieniony i może spowodować nieprzewidzia- 
ne skutki. Taka sytuacja występuje stosunkowo rzadko, nie- 
mniej jednak należy się przed nią zabezpieczyć - najpros- 
tszym sposobem jest wykonywanie programu za pomocą komendy 


SS Z. 


SYMBOL SHIFT K__ + 


kontynuuje wykonywanie programu od adresu znajdującego się 


w liczniku rozkazów (PC). 


Komendy tej używa się najczęściej w połączeniu z «omendą W» 
Najlepiej wyjaśni to przykład: 

Wykonujemy poniższy program po jednym rozkazie (używając 
SS Z) i doszliśmy do adresu *CJA2, 


CJA2 ED 4A SBC  HL,BC 
C3A4 19 XOR C 
C3ZA5 1E FP LD  E,*FP 
C3A7 BO ADD A,B 
C3JA8 BE CP A,(HL) 


C3JA9 DĄ 21 DO CALL NC,*D021 
CJAC 11 AO AO LD DE,* AOAO 
CZAF CD 11 C4 CALL «C411 

0332 DA E2 C3 JP C,„*C3JE2 


Interesuje nas stan znaczników po powrocie z podprogramu za” 
czynającego się od adresu *+0411,.Ustawiamy Wskaźnik Pamięci 
na adres *€03B2 (po rozkazie CALL +C411) i wpisujemy adres po= 


wrotu używ” jęc komendy i... Następnie naciskamy SYMBOL SHIFT i K» 


Prozram zostanie wykonany od adresu znajdującego się w licz= 
niku ro:kazów (PC), czyli, w tym przypadku, od £CJA2., Po 
dojściu do adresu, w który wpisaliśmy adres powrotu (+C3B2), 
wykonanie prosramu zostanie zatrzymane, po czym tablica zos= 
tanie uaktualniona (w programie MONS3).W programie MONS3M21 
po wykonaniu komendy SS K generowany jest krótki sygnał 
dźwiękowy a tablica jest uaktualniana po naciśnięciu dowol- 


nego klawisza. 


SYMBOL SHIFI T__> 
wpisuje adres powrotu po bieżącym rozkazie i kontynuuje wyko= 


nywanie programu. 


Przykład: 

B2371 2B DEC HL 

B232 CD CALL *A732 

B233 82 

B234 A7 

B23> 21 LD HL,*9FFF 

B236 FF 

B231 3E 
*ykonując progran po jednym rozkazie doszliśmy do adresu 
+B.2.. Jeżeli teraz użyjemy komendy s5 Z, to wysonywanie pro= 
»ramu bydzie kontynuowane od udresu *A782 - początek pod»ro= 
„ramu, Jeśli nie intrre.uje nas przezlądanie tego podprogramu, 
to wystarczy nacisnąć SYMBJL SHIFT i T. Adres vowrotu zosta- 
nie wpisany 0 ro:zaz'e CALL *A732, czyli w ad:esie *B235, 
i wykonywanie programu będz:e kontynuowane podobnie jak w przy- 


padku Komendy -S Ko 


J 


powoduje wykon: nie programu od podanego adresu. 


Adres wpisujemy ovo ":"., Przed skokiem do podanego adresu 
nast4)i wyczyszczenie stosu wewnętrznego. Jeśli chcemy, aby 
po wykonaniu progra'u, nastąpił powrót do tablicy MONS3, na- 
leży wpisać adres powrotu (W) w żądanym miejscu, 
przykład: 
J:CO000 ENTER  wy.ona program od adresu %CO00 
Przed wpisaniem znasu kończącego adres możemy wycofać się z 
tej komendy naciskając CAPS SiIFL 50 
Uwaga: komenda J niszczy zawartość rejestrów przed wykonaniem 
danego programu. Program do wykonania nie powinien 
więyc zakładać określonych wartości w rejestrach, Je*li 
ciicemy, aby program został wykonany z danymi wartościa= 


mi rejestrów, należy użyć komendy LS K. 


2.4 Wyświetlanie zawartości pamięci. 


L 


wyświetla blok pamięci od «dresu we Wskaźniku Pamięci 


L usuwa tablicę 053 i wyswietla zawartość 30 komórek pa= 
mięci poczynając od adresu wskazywane»o przez Wskaźnik Pamię- 
ci. Obruz sx«łada się z dwudziestu linii, każda zawiera adres 
(dziesiętny lub szesnastxowy - tak, jak na tablicy - patrz: 
komenda SS 3), 4 lic by szesnastkowe oznaczające zawartości 
kolejnych czterech bajtów pamięci oraz 4 zna:i w kodzie ASCII 
odsvowiadające tym bajtom. Jeeli zawzrtość danego bajtu prze- 
iracza liczbę 127 (%7P), zostaje ona pomniejszone o 128, dla 
celów re:'rezentacji w :odzie ASCII. Wartości od 0 do 31 włą- 
czn.e są przedstawiane jako "„", 


Powrót do tablicy M0NS3 nastąpi © naciśnięciu CAPS SHI*" 5; 
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naciśnięcie dowolnego innego klawisza (oprócz CAPS SHIFT 1) 


Spowoduje wyświetlenie następnego bloku pamięci, 


SYMBOT SHIFT P s 
jest to taka sama komenda jak L z tym, że wydruk skierowany 


jest na drukarkę, a nie na ekran. 


Powrót do tablicy MONS3, po wydrukowaniu jednej strony 
(80 bajtów pamięci), następuje po naciśnięciu CAPS SHIFT 5, 
a naciśnięcie dow>lnego innego klawisza (oprócz CAPS SHIFT 1) 


Spowoduje wydrukowanie kolejnej strony, 


2.5 Przeszukiwanie pamięci 


G 


przegląda pamięć w poszu<iwaniu podanego ciągu znaków. 
Znaki podajemy w odpowiedzi na ":", w postaci liczb szesnast= 
kowych (vo jednym bajcie) zakończonych ENTER. Wciśnięcie 
BNTER, bez liczby, zakończy definiowanie poszukiwanego cią- 
gu. 

Przeszukiwanie rozpoczyna się od adresu we Wskaźniku Pamię- 
ci. Z chwilą znalezienia podanego ciągu, tablica zostaje 
zmieniona ta:,żc Wskaźnik Pamięci jest ustawiony na pier- 
wszy znak szukanego ciągu, 

Przykład: chcemy znaleźć ciąg *2B *02 (2 bajty), zaczynając 
od adresu *+0250: 


M:C250 ENTER ustawiamy Wskaźnik Pamięci na *C250 


G:2B ENTER definiujemy pierwszy bajt ciągu 
:2 EN'TER drugi bajt 
: ENTER koniec definicji 


batrz: komenda N. 
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A. 


przegląda pamięć w poszukiwaniu ostatnio zdefiniowanego 


ciągu (patrz: komenda G) 


Komenda G pozwala na zdefiniowanie poszukiwanego ciągu 

i wskazuje pierwszy napotkany ciąg - dalsze przeszukiwanie 
umożliwia komenda N. N zaczyna przeszukiwać pamięć od adre- 
su we Wskaźniku Pamięci i ustawia Wskaźnik na adres pier- 


wszego znaku znalezionego ciągu. 


2.5 Modyfikacja zawartości pamięci 


zawartość komórui pamięci o adresie wekazywanym przez Wskaź” 
nik Pauiyci możemy zmieniać wpisując liczbę szesnastkową 
zakończoną dowolnym znakieu (patrz: rozdział 1). Dwie mniej 
znaczące cytry (jeżeli napiszemy tylko jedną cyfrę, zosta- 
nie ona uzupełniona zerem z lewej strony) zostaną wpisane 

do komórki pamięci o adresie we Wskaźniku Pamięci, a nas- 
tępnie, jeśli znakiem kończącym był symbol którejś z komend, 


komenda ta zostanie wykonana, 


Przykłady: 
30 SPACE *20 zostanie wpisane do komórki 
adresowanej przez Wskaźnik Pamięci 
D ENTER *0D zostanie wpisane i Wskaźnik Pa- 
mięci zwiększony o jeden 
3B4A *4A zostanie wpisane 
22X *22 zostanie wpisane i wykona się 


komenda X 


wpisuje do obszaru pamięci określoną wartość. 


Adresy początku i końca obszaru pamięci podajemy w odoowie- 
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dzi na "First:" (pierwszy bajt) i "Last:"* (ostatni bajt). 
Następnie po "With:", podajemy wartość, którą chcemy wpisać, 
np» : 


P 

First: AO000 ENTER adres początku obszaru pamięci 
Last: A200 ENTER adres końca obszaru pamięci 
With: FP ENTER wartość 


W komórki o adresach od wAO00 do wA200 włącznie zostanie 


wpisana liczba *FF. 


<< 


Wpisuje znaki ASCII do pamięci począwszy od adresu wska- 


zywanego przez Wskaźnik Pamięci. 


Y podaje nową linię gdzie możemy wpisywać znaki ASCII bez- 
pośrednio z klawiatury. Liczby odpowiadające tym znakom zos= 
taną wpisane do pamięci począwszy od adresu we Wskaźniku Pa= 
mięci, Wpisując znaki możemy używać DELETE (CAPS SHIFT 8) 

w celu skasowania znaku a cały ciąg należy zakończyć wciska= 
jąc <=(CAPS SHIFT 5). Po wykonaniu komendy Y, Wskaźnik Pamię- 


ci zostanie ustawiony po ostatnim znaku wpisanego ciągu, 


I 


inteligentne kopiowanie 

Blok pamięci zostanie skopiowany z jednego miejsca na drugie, 
Kopiowanie jest inteligentne w tym sensie, że blok może być 
kopiowany na obszar pamięci zachodzący na ten blok. 

W odpowiedzi na "First:" podajemy adres początku bloku, któ 
ry chcemy skopiować, a po "Last:", adres końca bloku tzn. 
adree ostatniego bajtu tego bloku. Następnie wpisujemy adres 


początku obszaru pamięci, na który chcemy podany blok SXo- 


2,53 = 


piować (w odpowiedzi na "To:"), Adresy należy podawać w 
postaci liczb szesnastkowych. Jeśli adres początku bloku 
jest większy niż adres końca - komenda nie zostanie wykona- 


na. Przykład: 


I 

First: C335 

Last: C339 

To: C337 
C334 Cc334 
C335 C335 
Cc336 C336 
C€337 337 
C338 C333 
c339 c339 
C33A CZ3A 
C33B C33B 
C33C C33C 


2.7 Modyfikacja zawartości rejestrów 


. 


Jeśli wpisaną liczbę szesnastkową zakończymy "," (SYMBOL 
SHIFT M),to zostanie ona wpisana do rejestru oznaczonego 
Wskaźnikiem Rejestru ">9", Po wejściu do programu MONS3M21, 


wskaźnik Rejestru wskazuje licznik rozkazów (PC). 


Wskaźnik Rejestru możemy przesuwać za pomocą "„" (bez licz- 
by). Będzie on wskazywał kolejne rejestry oprócz SP i IR, 
których zawartości nie możemy zmienić, 

Przykłady: 4 

załóżmy, że Wskaźnik Rejestru jest ustawiony na PC 


. przesuń Wskaźnik Rejestru na IY 


EST NE” 


Ę przesuń Wskaźnik Rejestru na IX 


p. wpisz Ó do rejestru IX 

. przesuń Wskaźnik Rejestru na HL 

1ABP. wpisz 41ABF do HL 

. przesuń Wskaźnik Rejestru na DE 

. przesuń «.skaźnik Rejestru na BC 

FF, wpisz %0/7F do BC 

. przesuń wskaźnik Rejestru na AF 

FEOO wpisz «rr do rejestru A i wyzeruj wszystkie znacze 
niki stanu 

. przesuń wskaJjnik Rejestru na PC 

9200, ustaw licznik rozkazów na adres *9200 


zmienia zestaw wyświetlanych rejestrów 


Po wejściu do programu MOIL3M21, na tablicy wyświetlany jest 
zestav rejestrów podstawowych (tzn, IiL, DE, BC, AV"). Po nae 
ciśnięciu Q, wyświetlon, zostanie zestaw rejestrów dodatko= 
wych (tzn. HL, DE, BC, AF”), wyróżnionych apostrofem "'", 
Ponowne użycie komendy Q przywróci wyświetlanie podstawowem 
go zespołu rejestrów roboczych. Zawartość rejestrów dodat 


kowych możemy również modyfikować za pomocą "o". 


2.3 Zmiana zapisu liczb 


5SZ5BOL SHIFT 3 * 
zmienia wyświetlane adresy z zapisu szesnastkowego na dzie” 
siętny lub odwrotnie. Dotyczy to również zapisu adresów po- 


dawanych podczas deasemblacji kodu oraz wyświetlania zawar- 


tości pamięci. 


Liczby pokazujące zawartość komórek pamięci są zawsze wyś- 


wietlane w zapisie szesnastkowym. 


H 


Zamienia liczbę dziesiytną na szesnastkową. 
Po ":" wprowadzamy liczbę dziesiętną zakończoną dowolnym 
znakiem oprócz cyfry (0-9). W tej samej linii wyświetlony 
zostanie znak *=" oraz liczba szesnastkowa. Po naciśnięciu 
dowolnego klawisza możemy wprowadzac następne komendy, 
Przykład: 

H:45705 = AAP5 
Czasami będziemy potrzebowali zamienić liczbę szesnastkową 
na dziesiętną, Najprostszym sposobem dokonania takiej za- 
miany jest wpisanie liczby szeanastkowej do któregoś z re- 
jestrów a następnie użycie komendy SS 3 aby zamienić ją na 


liczbę d.iesiętną, 


2,9 Powrót do systemu operacyjnego ZX Spectrum 


CAPS SHIFT 1 EDIT 
Komenda ta może być wykonana w dowolnym momencie pracy pro- 
gramu MONS3M21 , 
Aby ponownie wejść do programu MONS3M21 należy wpisać: 
RANDOMIZE USR (adres początku programu) 
a w przypadku programu MONS3: 
RANDOMIZE USR (adres początku programu + 29) 
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ROZDZIAŁ 3e PRZYKŁAD UŻYCIA PROGRAMU MONS3M21 

W przykładzie wykorzystamy program podany w załączniku 
instrukcji do programu GENS3M21. Kod wynikowy umieszczony 
został od adresu *DOOO, 


Oto pełny tekst programu: 


DO00  ED4RB33D0 LD  BC,(LDO33) ; część I 
DO04  ED5B35L0 LD  DE,(LDO35) 

DO03 C€D37D0 CALL LDO37 

DOOB 7A LD A,D 

DOOC  CD1CDO CALL LDO1C 

DOOR  7B LD A,E 

DO10 CD1CDO CALL LDO1C 

DO13 70 LD A,L 

DO14 CD1CDO CALI, LDO1C 

b0O17  7D LD A,H 

L018  CD1CDO CALL LDO1C 

M1R  C9 RET 

DO1C +5 LDO1C PUSH AP część II 
DO1D OF RCA 

DO1E Or RxCA 

DO1TF OP RRCA 

DO20 OF RKCA 

DO21 CD25DO CALL LDO25 

DO24 PI POP AP 

DO25 1:615 LDO25 AND 415 

DO27 C690 ADD A,4390 

Do29 27 DAA 

DO2A  CE40 ADC A,e40 

DO2C 27 DAA 

DO2D FD213A5C LD  IY,w5CJA 

DO31 17 RST «10 

bn3» c9 RET 

bO33 4080 LDO33  LEFB "©",49C ; mnożna 
D0355  FAOO LDO35  DzFB *FA,wO ; mnożnik 
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DO37 210000  LDO37 LD  HL,40000 część III 
DO3A 3E10 LD  A,410 
DO3C 29 LDO3ŻC ADD HL,HL 
DO3D EB EX  DE,HL 
DO3R  EDGA ADC HL,HL 
DO40 EB EX  DE,HL 
DO41. 3004 JR _ NC,LDO47 
DO43 09 ADD HL,BC 
DO44 3001 JR NC,LDO47 
DO46 13 INC DE 

DO47 3D LDO47 DEC A 

DO48 20F2 JR _ NZ,LDO3C 
DO4A C9 RET 


Chcemy zobaczyć jak działa procedura znajdująca się w trzeciej 
części kodu. Procedura ta mnoży dwie liczby 16-bitowe bez 
znaku. Liczby te znajdują się w parach rejestrów BC i DE. 32- 
-bitowy wynik mnożenia umieszczany jest w rejestrach DE (bar- 
dziej znaczące 16 bitów) i HL (mniej znaczące 16 bitów). 
Fragment kodu w części pierwszej przygotowuje parametry dla 
procedury mnożącej, wywołuje ją a następnie wywołuje procedurę 
z części drugiej wyprowadzającą zawartość rejestru A (w postaci 
liczby szetnastkowej) na ekran. Procedura ta wywoływana jest 
cztery razy dla każdego z rejestrów, w których umieszczony jest 
wynik mnożenia (HLDE). 


Działanie programu możemy sprawdzić za pomocą poniższych komend: 


M: DOOO ENTER ustawiamy Wskaźnik Pamięci na początek programu 


DOOO. wp (jemy ten adres do licznika rozkazów PC 

SS Z wykonujemy jeden rozkaz 

SS Z jw - do rejestrów BC i DE wpisane zostały 
mnożna i mnożnik 

SS Z wywołujemy procedurę mnożącą 

SS Z wpisujemy 0 do HL 
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Ss Z i w10 do A (licznik bitów) 
SS Z (4 razy) DEHL zostało przesunięte w lewo 
SS Z skok do £DO47 
ss Z zmniejszamy licznik bitów 
Ss Z skok z powrotem itd. 
po zorientowaniu się jak działa ten fragment: 
ś ustawiamy Wskaźnik Pamięci na adres powrotu 
z procedury mnożącej 
LJ wpisujemy adres powrotu w tym miejscu 
SS K kontynuujemy wykonywanie procedury 
po sygnale dźwiękowym naciskamy dowolny klawisz$ 
w rejestrach DEHL znajduje się wynik mnożenia 
Ss Z wpisujemy pierwsze 8 bitów wyniku do akumulatora 
Ss Z wywołujemy procedurę wyprowadzającą zawartość 
akumulatora na ekran 
. ustawiamy Wskaźnik Pamięci na adres na stosie 
w i wpisujemy adres powrotu 
Ss K wykonujemy całą drugą część 
na ekranie po znaku "+* pojawi się "00" - 
zawartość rejestru A 
Ss Z wpisujemy następne 8 bitów wyniku do rejestru A 
SST wpisujemy adres powrotu po bieżącym rozkazie 


1 wykonujemy całą procedurę itd. 


Możemy również sprawdzić działanie samej procedury mnożącej 
dla dowolnie wybranych liczb, np. 50000 i 60000: 


M: DO37 ustawiamy Wskaźnik Pamięci na początek procedury 
mnożące j 

DO37 » wpisujemy ten adres do PC 

. przesuwamy Wskaźnik Rejestru 
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Wskaźnik Rejestru wskazuje na DE 
zamieniamy pierwszą liczbę na postać szestnastkową 
wpisujemy tę liczbę do DE 
przesuwamy Wskaźnik Rejestru do BC 
zamieniamy drugą liczbę 
i wpisujemy ją do BC 
oglądamy działanie procedury 
... 
ustawiamy Wskaźnik Pamięci na koniec procedury 
wpisujemy adres powrotu 
kontynuujemy wykonywanie procedury do końca 
po naciśnięciu dowolnego klawisza możemy obejrzeć 


wynik: *B2DO5E00 = 3000000000 
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ZAŁACZNIK TABLICA MONB3 


9092 2836 JR _ Z,%90CA 

>PC 9092 28 36 EB 09 D5 E5 5E 
SP 750F  2B 2D 65 33 58 27 ED 
IY 5C3JA FF ED 00 22 75 23 75 
IX 2152 04 OC OD 20 FD OE 3F 
HL 2152 CD 2C OF FD.CB 01 EE 
DE FFOO 00 00 00 00 00 00.00 
BC 0053 El 6E FD 75 00 EB 7B 
AF FFAC S V 
IR 3FO00 


W pierwszej linii, u góry ekranu, znajduje się adres pamięci, 
na który Uatasdoty jest Wskaźnik Pamięci (9092) oraz zawartość 
bajtów bieżącego rozkazu (2836) wraz z zapisem symbolicznym 
GGEKAGE (JR 2,490CA), 

W kolejnych dziewięciu liniach przedstawione są rejestry mik- 
roprocesora 280; „nazwa AE PPLĄ (lub pary rejestrów) i jego 
zawartość, np.: HL 2152 oznacza, że w rejestrze H znajduje się 
421, aw L - 452, Siedem kolumn liczb na prawo od rejestrów 
PC + BC, to zawartości kolejnych komórek pamięci począwszy od 
adresu znajdującego się w rejestrze, np.: w rejestrze SP znaj- 
duje się wartość 49092, a 428 tę zawartość komórki pamięci o 
tym adresie, 436 - komórki o adresie 49093, 4*EB - 49094 itd, 
Zawartość rejestru znaczników stanu mikroprocesora (F) jest 
dekodowana - jeśli znacznik jest równy jeden, to jego symbol 
jest wyświetlany obok; W powyższym przykładzie S i V. 


Symbole znaczników stanu są następujące: 


S znak 

zero 

przeniesienie pomocnicze 
parzystość lub nadmiar 
odejmowanie 


Q Z GO NU 


przeniesienie 
Wskaźnik Rejestru, ">", wskasuje na rejestr PC. 


Następna część Tablicy MONS3 przedstawia adresy: 24 komórek 
pamięci (w przykładzie od 49086 do 4909D) wraz z ich zawar 


tością. Adres we Wskaźniku Pamięci jest oznaczony przez "> 4", 


Znak ">", u dołu ekranu, wskazuje na miejsce gdzie wprowadzane 
są komendy. Tablica MONS3 jest uaktualniana po wykonaniu każdej 


komendy. 
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INDEKS KOMEND PROGRAMU MONS3M21 


1. Ustawianie wskaźnika Pamięci (WP) 


M aa WP:=aa 

ENTER WP:=WP+1 

css * :=WP+8 

cs7 * i=WP-1 

cs5 "” HP: =WP-8 

x WPy:=WP , WP;:=M(WP) , WP ż=M( WP+1) 
V WP:=WP, 

o WP,:=WP , WP:=WP+M(WP)+1 

U WPz=WPO 

5 WP; :=l( SP) ż WPy :=M(SP+1) 


2. Deasemblacja kodu 
SS4 $ deuse'ublac.a od adresu w WP 
Taa deasemblacja od adresu aa - również: na drukarkę 


oraz generowanie tekstu dla programu GENS3M21 


3. Wykonywanie programów w kodzie maszynowym 


Ss Z s wykonywanie kodu po jednym rozkazie od adresu 
w WP 

w wpisywenie adresu powrotu w miejsce wskazywane 
przez WP 

SSK + wykonywanie kodu od adresu w liczniku rozkazów 
(Pc) 

ssT >» wyk nywanie kodu od adresu w WP po uprzednim 


wpicaniu adresu powrotu po bieżącym rozkazie 


J aa wykonywanie kodu od adresu aa 


4, Wyświgjzynie zawartości pamięci 
L : wyświetlanie zawartości pamięci od adresu w WP 
SSP R jw aqe wydruk skierowany na drukarkę 
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5. Przeszukiwanie pamiyci 
G Nioo sote przeglądanie pamięci w poszukiwaniu ciągu 
liczb LOL 


N dalsze przeszukiwanie 


6. Modyfikacja zawartości pamięci 


n M(WP):=n 

P wpisywanie podanej liczby do obszaru pamięci 

Y wpisywanie znaków ASCII do pamięci od adresu 
w WP 

1 kopiowanie bloku pamięci 


7. Modyfikacja zawartości rejestrów 


. przesuwanie wskaźnika Rejestru (WR) 
nne R(WR) :=nn 
U zmiana zestawu wyświetlanych rejestrów 


3. Zmiana zapisu liczb 

53 % zmiana wyświetlanych adresów z systemu szestnast= 
kowego na dziesiętny lub odwrotnie 

Kd zamiana podanej liczby dziesiętnej d na liczbę 


szestnastk :wą 


9, Powrót do systemu operacyjnego ZX Spectrum 
c5 1 EDIT 


oznaczenia: WP - Wskaźnik Pamięci 

M(WP) - zawartość komórki pamięci o adresie WP 

M(SP) > zawartość komórki pamięci o adresie 
we wskaźniku stosu SP 

R(WR) - zawartość rejestru wskazywanego przez 
Wskaźnik Rejestru WR 

aa - adres 16-bitowy 

n - liczba 8=bi towa 

nn - liczba 16-bitowa 

d - liczba dziesiętna 


PIU TREŚCI 


Ust:;p 

Część I  GZNS3M21 

tozdział 1 Uruchomienie programu 

1.1 Ładowanie i uruchamianie programu GENS3M21 

1.2 żadowanie i uruchamianie programu GENS3 

Rozdział 2 Opis programu GENS3M21 

2.1 Zasada działania asemblera 

2.2 Postać wierszy programu 

2.5 Etykiety 

2.4 Licznik Adresów 

2.5 Tablica symboli 

2.6 Wyrażenia 

2.7 Dyrektywy asemblera 

2,3 warunkowe pseudo-=mnemoniki 

2.9 Komendy asemblera 

Rozdział 3 Edytor 

3.1 Wprowadzenie 

3.2 Komendy edytora 

%,3 Przykład użycia edytora 

Rozdział 4 Przykład pracy z programem GENS3M21 

załącznik 1 Opis błędów 

Załącznik 2 Słowa zastrzeżone, mnemoniki, 
dyrektywy i komendy asemblera 

CZĘŚĆ II  MNOS3M21 


Rozdział 1 Uruchomienie programu 


Rozdział 2* Komendy 


2,3 
2.3 


Ustawianie Wskaźnika Pamięci 
Deasemblacja kodu 

iJykcnywanie programów w kodzie wynikowym 
wyświetlanie zawartości pamici 
Przeszukiwanie pamięci 

Modyfikacja zawartości pamięci 
Modyfiricją zawartości rejestrów 

zmiana zapisu liczb 


Powrót do systemu operacyjnego ZX Spectrum 


Eozdział % Przykład użycia programu MONU3M?1 


załącznik Tablica MONS *% 


Indeks komend programu MONZZM21 


48 
48 
51 
56 
60 
61 
62 
64 
65 
66 
67 
11 
173 


Stołeczny 
Ośrodek 
Elektronicznej 
Techniki 
Obliczeniowej 
SOETO 


00-682 WARSZAWA, ul. Hoża 50 
telefon: 218326 
telex: 814786 


Wykonuje: 
Usługi informatyczne 


na bazie sprzętowej 
komputerów serii ODRA i RIAD 


Usługi w zakresie 
informatyki mikrokomputerowej 


SOETO — STUDIO 
MIKROKOMPUTEROWE *BIT"” 


00-060 WARSZAWA, ul. Królewska 27 
telefon: 277281 w. 526 
— realizuje różne formy szkolenia 
— wydaje materiały szkoleniowe 
— prowadzi „SALON GIER” 
— wykonuje usługi obliczeniowe 
realizując hasło: 
MIKROKOMPUTERY: 
— UCZĄ 
— BAWIĄ 
— PRACUJĄ 


COPYRIGHT BY SOETO 


Cena 360 zł 
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83331 


DRUK: Z.P. WOŁOMIN UL. Wł. SIKORSKIEGO 70 
ZAM. 883/86 NAKŁAD 1000 EGZ. P-23 


